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为 了 满足 读者 对 网 络 和 软件 技术 知识 的 迫切 需求 ， 世 界 著 名 计算 
机 图 书 出 版 机 构 O'Reilly Media, Inc. 授 权 机 械 工 业 出 版 社 ， 翻 译 出 版 一 
批 该 公司 久 负 感 名 的 英文 经 典 技术 专著 。 


O'Reilly Media, Inc. 是 世界 上 在 UNIX、X、Internet 和 其 他 开放 系统 
书 领域 具有 领导 地 位 的 出 版 公司 ， 同 时 也 是 联机 出 版 的 先锋 。 


从 最 畅销 的 《The Whole Internet User's Guide& Catalog) (被 纽约 
公共 图 书馆 评 为 20 世 纪 最 重要 的 50 本 书 之 一 ) 到 GNN (最 早 的 Internet 
门户 和 商业 网 站 ) ， 再 到 WebSite (第 一 个 蜗 面 PC 的 Web 服 务 器 软 
件 ) ，O'Reilly Media, Inc. 一 直 处 于 Internet 发 展 的 最 前 沿 。 


许多 书店 的 反馈 表明 ，O'Reilly Media, Inc. 是 最 稳定 的 计算 机 图 书 
出 版 两 一 每 一 本 书 都 一 版 再版 。 与 大 多 数 计算 机 图 书 出 版 商 相 比 ， 
O'Reilly Media, Inc. 具 有 深厚 的 计算 机 专业 背景 ， 这 使 得 O'Reilly 
Media, Inc. 形 成 了 一 个 非常 不 同 于 其 他 出 版 商 的 出 版 方针 e O'Reilly 
Media, Inc. 所 有 的 编辑 人 员 以 前 都 是 程序 员 ， 或 者 是 顶尖 级 的 技术 专 
Z ° O'Reilly Media, Inc. 还 有 许多 固定 的 作者 群体 一 他 们 本 号 是 相关 领 
域 的 技术 专家 、 WRK, MEMEA, O'Reilly Media, Inc. 依 靠 


他 们 及 时 地 推出 图 书 。 因 为 O'Reilly Media, Inc. 紧 密 地 与 计算 机 业界 联 
系 着 ， 所 以 O'Reilly Media, Inc. 知 道 市 场 上 真正 需要 什么 图 书 。 


译 者 序 


基本 上 所 有 应 用 程序 都 要 与 数据 打交道 ， 如 何 操 纵 和 处 理 抵 层 数 
据 库 曾 经 是 一 个 让 人 非常 头痛 的 问题 ， 尤 其 对 于 Java 新 手 来 说 ， 更 是 
TaD Ra? 


如 有 果 直 接 使 用 最 的 层 的 JDBC 来 访问 数据 库 ， 再 在 代码 中 来 洒 上 无 
数 的 SQL 语句 ， 以 这 样 的 方式 来 手工 编写 代码 不 仅 单调 了 乏味、 易于 出 
错 ， 而 且 会 占用 整个 应 用 程序 的 很 大 一 部 分 开发 工作 量 。 关 键 是 这 样 
得 到 的 最 终 产 品 往往 与 故 层 的 数据 库 紧 密 地 厦 合 在 一 起 ， 如 果 要 更 换 
数据 库 ， 必 须 花 费 大 量 的 人 力 资 源 。 


优秀 的 面 问 对象 开 发 人 员 厌 倦 了 这 种 重复 性 筋 动 ， 他 们 开始 采用 
通常 的 “积极 ”偷懒 做 法 ， 即 创建 工具 ， 使 整个 过 程 目 动 化 。 对 于 关系 
数据 库 来 说 ， 这 种 努力 的 最 大 成 果 就 是 对 象 /关系 映 冉 (ORM) T 
具 ， 而 Hibernate 则 是 这 些 工具 中 的 典型 代表 。 


Hibernate 是 一 个 免费 的 开源 Java 包 ， 它 使 得 与 关系 数据 库 打交道 
变 得 十 分 轻松 就 像 数 据 库 中 包含 的 古 普 通 Java 对 象 一 样 ， 不 必 考 虑 
如 何 把 它们 从 神秘 的 数据 库 表 中 取出 (或 放 回 数据 库 表 中 ) 。 
Hibernate 解 放 了 广大 Java 程 序 开 发 人 员 ， 使 他 们 可 以 专注 于 应 用 程序 
的 对 象 和 功能 ， 而 不 必 担 心 如 何 保存 它们 或 稍 后 如 何 找到 它们 。 


Hibernate 之 所 以 能 够 流行 ， 应 该 归功 于 以 下 优点 : 


1) Hibernate 是 JDBC 的 轻 量 级 对 象 封 装 ， 它 是 一 个 独立 的 对 象 持 
D Je REAR, Aj App Server、EJB 没 有 什么 必然 的 联系 。Hibernate 可 以 用 
在 任何 JDBC 可 以 使 用 的 场合 。 


2) Hibemate 是 一 个 和 JDBC 密 切 关联 的 框架 ， 所 以 Hibernate 的 兼 
容 性 与 JDBC 驱 动 、 数 据 库 都 有 一 定 的 关系， 但 是 与 使 用 它 的 Java 程 
序 、 瓜 层 数 据 库 没有 任何 关系 ， 也 不 存在 兼容 性 问题 。 


3) Eclipse 等 主流 Java 集 成 开发 环境 对 Hibernate 有 很 好 的 文 持 ， 在 
大 型 项 目 ， 特 别 是 持久 层 关 系 映 喘 很 复杂 的 情况 下 ，Hibernate 效 率 非 
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为 了 让 以 前 对 Hibernate 了 解 不 多 的 Java 爱 好 者 快速 掌握 Hibernate 
的 基本 配置 、 使 用 方法 、 经 验 技 巧 ， 以 及 它 与 其 他 常用 开发 工具 的 协 
同 配合 ， 本 书 的 作者 由 一 个 简单 而 现实 的 示例 入 手 ， 从 数据 表 的 创 
建 ， 讲 到 各 种 基于 数据 库 的 操作 ， 长 至 还 创建 了 一 个 简洁 的 Web 网 
站 ， 内 容 涉及 Hibernate 的 方方面面 。 讲 解 非常 细致 ， 不 仅 包 括 了 足以 
帮助 读者 理解 的 源 代 码 ， 而 且 对 于 每 一 操作 步 又， 作者 都 给 出 了 详细 
的 操作 命令 。 相 信 读 者 在 阅读 和 实践 本 书 示例 的 过 程 中 一 定 不 会 遇 到 
太 大 的 问题 ， 而 且 能 够 以 最 短 的 时 间 来 掌握 Hibernate， 这 应 该 天 是 本 
书 最 可 贯 的 价值 所 在 了 。 


本 书 在 结构 上 分 为 两 大 部 分 。 前 一 部 分 主要 介绍 Hibernate 框 丸 目 
身 的 功能 ， 后 一 部 分 则 介绍 Hibernate 与 其 他 IDE 和 开发 工具 的 配合 使 
用 。 所 有 讲解 并 非 照 本 宣 科 式 地 照搬 API 文 档 和 参考 手册 ， 而 古 时 时 
处 处 渗透 着 作者 在 使 用 Hibernate 过 程 中 所 领悟 到 的 经 验 和 体会 ， 尤 其 
征 在 讲解 Hibernate 的 关联 映射 配置 时 ， 虽 然 我 目 训 已 经 使 用 Hibernate 
很 多 年 了 ， 但 还 是 学 到 不 少 知识 点 ， 这 些 在 API 和 参考 手册 中 没有 遇 
到 和 使 用 过 。 第 二 部 分 中 介绍 的 各 种 开发 工具 也 是 成 熟 的 Java 开 发 人 
员 不 可 或 缺 的 利 侨 ， 对 它们 的 掌握 和 理解 ， 古 超越 普通 程序 员 的 必 经 
之 路 。 


在 翻译 过 程 中 ， 虽 然 我 力求 在 忠于 原文 的 基础 上 ， 尽 可 能 从 专业 
Java 开 发 人 员 的 角度 来 做 到 信 、 达 、 雅 ， 但 由 于 目 身 水 平 有 限 ， 必 有 是 
会 有 诸多 不 足 ， 硕 望 各 位 读者 不 音 指 教 。 
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还 要 感谢 我 的 家 人 ， 没 有 他 们 的 支持 也 无 法 完成 这 本 书 的 翻译 。 


最 后 ， 人 钢 大 家 能 够 在 阅读 中 至 受 技术 进步 带 来 的 乐趣 1! 
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By S 


Hibernate 是 为 Java 设 计 的 轻 量 级 对 象 /关系 映射 (object/relational 
mapping) 服务 。 这 是 什么 意思 ? 这 就 是 说 ，Hibernate 可 以 让 你 用 普通 
的 Java 对 象 的 形式 来 简洁 而 有 效 地 处 理 天 系数 据 库 中 的 信息 。 不 过 ， 
这 样 的 说 明 仍然 无 法 贴切 地 表达 这 项 技术 是 多 么 有 用 和 令 人 激动 。 持 
有 这 种 观点 的 人 并 非 只 是 我 一 个 : Hibernate 2.1 顾 得 了 (Software 
Development》 杂 志 第 14 届 “框架 库 和 组 件 ”震撼 大 奖 (Jolt Award) ° 

(本 书 是 《Hibernate: A Developer's Notebook) 的 后 续 更 新 版 本 ， 我 
非常 采 驻 地 编写 了 这 本 书 。 这 本 书 第 1 版 本 介绍 的 是 Hibernate 2， 它 获 
得 了 第 15 届 Jolt 技 术 类 图 书生 产 力 大 奖 (Productivity Winner) ° 


ABA, Hibernate!) KARERE? 所 有 非凡 的 应 用 程序 (甚至 
许多 平凡 的 应 用 程序 ) 都 需要 存储 和 使 用 各 种 信息 ， 也 就 都 会 涉及 关 
系 型 数据 库 的 使 用 。 与 Java 对 和 象 世界 不 同 ， 数 据 库 通 常 要 求 使 用 者 具 
备 一 定 的 技巧 和 专业 知识 。 如 何 连通 这 两 个 世界 曾经 是 一 段 时 期 内 的 
一 项 重要 任务 ， 但 这 也 是 一 件 非 常 复 杂 而 乏味 的 工作 。 


大 多 数 人 要 事先 写 出 一 些 非常 繁琐 的 SQL 语句 ， 再 将 这 些 语 句 作 
为 字符 串 虑 入 到 Java 代 码 中 ， 接 着 再 使 用 JDBC (Java database 
connectivity) 执行 查询 语句 和 处 理 结果 。JDBC 已 经 发 展 成 为 一 个 与 数 
据 库 通信 的 、 功 能 丰富 且 非 常 灵 活 的 程序 库 ， 虽 然 现在 基于 这 种 方法 


还 可 以 提供 一 些 简 化 和 改进 的 措施 ， 但 在 Java 中 使 用 JDBC 还 相当 党 
珊 。 对 于 大 量 的 数据 处 理 ， 我 们 需要 某 种 功能 更 强大 的 工具 ， 将 对 数 
据 库 的 查询 从 代码 中 分 离 出 去 ， 并 以 面向 对 象 的 方式 将 它们 组 件 化 ， 
以 简化 对 数据 库 的 操作 。 


多 年 来 ， 我 自己 开发 的 软件 中 就 使 用 了 这 样 的 轻 量 级 (甚至 是 超 
轻 量 级 ) 对 象 /关系 映射 层 功能 组 件 。 该 组 件 最 初 起 源 于 我 的 同事 Eric 
Knapp 为 Lands' End 电 子 商 务 网 站 开发 的 Java 数 据 库 连 接 和 碍 询 池 缓 存 
系统 。 这 个 系统 引入 了 外 部 SQL 模板 的 思想 ， 可 以 通过 名 称 来 访问 模 
板 ， 并 有 效 地 与 运行 时 数据 组 合 起 来 ， 以 生成 实际 的 数据 库 查 询 。 
是 它 后 来 才 文 持 在 模板 中 增加 一 些 简单 的 映射 指令 ， 将 这 些 模 板 直接 
绑 定 到 Java 对 象 。 


虽然 它 远 不 及 像 现在 的 Hibernate 这 样 有 强大 的 功能 和 系统 ， 但 这 
种 方法 在 很 多 不 同 规模 的 项 目 和 各 种 环境 中 已 证 实 具 有 很 大 的 价值 。 
直到 本 书 的 第 1 版 ， 我 们 一 直 都 在 使 用 这 种 方法 ， 在 为 Cisco 公 司 的 
CallManager 平 台 建 立 了 了 电话 应 用 程序 时 ， 我 们 最 后 采用 了 这 种 方法 。 
不 过 ， 现 在 再 做 狐 项 目 时 ， 我 们 会 改 用 Hibernate。 在 学 习 完 本 书 以 
后 ， 你 会 明日 为 什么 要 做 这 样 的 选择 ， 而 且 也 可 能 会 做 出 同样 的 决 
定 。Hibernate 会 为 你 做 很 多 事情 ， 人 简单 到 让 你 几乎 起 记 是 在 处 理 数 据 
库 。 和 需要 什么 对 象 ， 束 直接 拿 来 使 用 即 可 。 这 束 是 这 种 技术 的 优点 和 
CE TaN? 


你 可 能 会 问 ，Hibernate 和 Enterprise JavaBeans (EJB) 有 什么 关 
R? 它们 是 彼此 竞争 的 技术 吗 ? 在 什么 情况 下 应 该 使 用 哪 种 ?事实 
上 ， 你 可 以 同时 使 用 这 两 种 技术 。 但 是 并 非 每 个 应 用 程序 都 需要 EJB 
的 复杂 性 ， 多 数 应 用 程序 只 需要 使 用 Hibernate 直 接 与 数据 库 交 互 ， 就 
足够 了 。 男 一 方面 ， 对 于 非常 复杂 的 三 层 (three-tier) 应 用 程序 环境 
而 言 ，EJB 有 时 是 不 可 或 缺 的 。 在 这 种 情况 下 ，EJB Session bean 可 以 
使 用 Hibernate 来 持久 保存 数据 ， 或 者 也 可 以 用 于 持久 化 BMP 实体 


bean ° 


事实 上 ，EJB 委 员 会 深 受 Hibernate 的 影响 ， 最 终 接受 了 Hibernate 
的 "plain old Java objects" (POJO) 的 方式 来 进行 持久 化 处 理 ， 这 是 一 
种 功能 强大 、 使 用 方便 的 持久 化 方式 ， 并 在 EJB 3 中 引入 了 Java 
Persistence Architecture (JPA) (可 以 脱离 EJB 环 境 使 用 ) ° Hibernate 
3 其 实 也 以 一 种 完全 可 移植 的 方式 实现 了 JPA (不 过 ， 在 第 7 章 中 可 以 
看 到 ， 你 可 能 仍旧 希望 使 用 Hibernate 的 JPA 扩 展 ) 。 


Hibernate 的 开发 很 明显 已 经 成 为 Java 和 关系 型 数据 库 交 互 的 分 水 
岭 事 件 。Java 界 应 该 感谢 Hibernate 之 父 Gavin King 和 他 的 团队 所 做 出 的 
贡献 ， 让 我 们 的 开发 更 加 倘 单 些 吧 。 这 本 书 殉 是 要 帮助 你 尽快 地 和 掌握 
这 项 技术 。 


本 书 走 么 使 用 


本 书 最 初 是 O'Reilly 的 Developer's Notebook 系 列 的 一 部 分 ， 可 帮助 
读者 快速 掌握 有 用 的 最 新 技术 。 虽 然 本 书 扩展 了 很 多 Hibernate 用 户 可 
能 想 要 了 解 的 技术 ， 但 本 书 不 打算 成 为 Hibernate 的 完整 参考 手册 。 本 
书 反映 了 作者 对 该 系统 研究 的 成 果 ， 从 最 初 的 下 载 ， 到 项 目的 配置 ， 
通过 一 系列 项 目 演示 了 如 何 完 成 各 种 实践 目标 。 


阅读 示例 并 实践 一 下 ， 你 不 但 能 够 快速 地 搭建 好 Hibernate 环 境 ， 
并 且 可 以 立即 将 它 用 于 实际 项 目的 开发 。 这 束 好 像 你 “跟着 我 " 走 过 我 
绘制 的 一 片 领地 ， 沿 途中 ， 我 会 指出 有 用 的 路 标 和 危险 的 陷阱 。 


虽然 我 一 定 会 介绍 一 些 背景 知识 ， 解 释 Hibernate 的 工作 原理 和 原 
因 ， 但 这 总 十 针对 某 项 任务 。 有 了 时， 我 会 建议 你 参阅 一 些 参 考 文 档 或 
其 他 在 线 人 资源， 以 便 深入 了 解 一 些 瓜 层 的 概念 或 其 他 Hibernate 使 用 方 
TURF RANT ° 


在 读 过 前 面 几 章 之 后 ， 束 不 需要 按照 章节 顺序 依次 阅读 了 ， 可 以 
直接 跳 转 到 你 特别 感 兴趣 或 关注 的 主题 。 你 可 以 目 己 构建 示例 代码 ， 
也 可 以 从 本 书 的 网 站 下 载 完整 的 源 代码 (可 以 在 前 一 革 示 例 代 码 的 基 
础 上 ， 按 照 当 前 革 市 的 说 明 ， 目 己 动 手 修 改 代码 ， 来 实现 正在 阅读 的 
代码 示例 ) 。 如 采 你 正在 学 习 的 示例 和 前 面 的 示例 有 关 ， 同 时 你 也 有 
兴趣 了 解 ， 则 可 以 随时 跳 转 到 先前 的 示例 。 


本 书 排版 字体 约定 


本 书 的 字体 有 特定 的 约定 ， 提 前 了 解 这 些 约定 将 有 助 于 你 对 本 书 
的 理解 。 


斜体 (Italic) 


用 于 文件 名 、 文 件 扩展 名 、URL、 应 用 程序 名 称 、 强 调 以 及 第 一 
次 引入 的 新 术语 。 


等 


等 宽 字 (Constant width) 


用 于 Java 类 的 名 称 、 方 法 、 ` 属性 、 数 据 类 型 、 数 据 库 元 素 
以 及 以 文本 方式 出 现 的 代码 片段 。 


等 宽 黑 体 字 (Constant width bold) 


用 于 在 命令 行 输入 的 命令 ， 以 及 突出 演示 在 运行 示例 中 插入 的 新 
代码 。 


oF BAS (Constant width italic) 
用 于 说 明和 输出 结果 。 
本 书 网 站 


本 书 的 网 站 地 址 是 : 
http://www.oreilly.com/catalog/9780596517724/， 提 供 了 一 些 你 想 要 了 解 


的 重要 信息 。 本 书 所 有 示例 按 章 ， 都 可 以 在 以 上 网 站 中 找到 。 
这 些 示例 文件 已 经 压缩 成 ZIP 和 TAR 文件 。 


多 数 情况 下 ， 各 章 世 都 会 用 到 一 些 相同 的 文件 ， 随 着 示例 功能 的 
不 同 ， 这 些 文件 不 断 增 加 一 些 新 代码 。 下 载 文档 中 每 一 章 的 目 孙 都 是 
相应 示例 系统 的 状态 快照 (snapshot) ， 反 映 了 该 章 的 所 有 变动 和 新 增 


如 何 联系 我 们 


请 将 有 关 本 书 的 评论 和 问题 寄 送 给 出 版 商 : 
美国 : 

O'Reilly Media, Inc. 

1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 


北京 市 西城 区 西直门 南大 街 2 号 成 饮 大 厦 C 座 807 室 (100035) 奥 
ABR A (北京 ;有 限 公司 


O'Reilly 的 每 一 本 书 都 有 专属 网 站 ， 你 可 以 在 那 找 到 关于 本 书 的 相 
天 信息 ， 包 括 勘误 表 、 示 例 代码 以 及 其 他 的 信息 。 本 书 的 网 站 地 址 


日 
XE: 


http://www.oreilly.com/catalog/9780596517724/ 


询问 技术 问题 或 对 本 书 进行 评论 ， 请 发 电子 邮件 到 : 


bookquestions@oreilly.com 
欲 获取 有 关 我 们 的 图 书 、 会 议 、 资 源 中 心 (Resource Center) 以 
及 O'Reilly Network 的 更 多 信息 ， 可 以 访问 我 们 的 网 站 : 


http://www.oreilly.com 


http://www.oreilly.com.cn 
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优秀 。 


[1] 一 部 成 功 的 美国 幼儿 电视 动画 片 。 


第 一 部 分 ”Hibernate 快速 入 门 


我 们 的 第 一 个 目标 就 是 尽快 地 了 解 Hibernate 的 最 新 进展 。 这 一 部 
分 的 大 多 数 章 是 基于 《Hibernate: A Developer's Notebook) 
(O'Reilly) 的 内 容 并 进行 了 更 新 ， 反 映 了 Hibernate 3 带 来 的 主要 变 
化 。 示 例 代码 现在 使 用 的 都 是 一 些 开 发 工具 的 最 新 版 本 ， 我 们 通过 它 
们 来 提供 一 个 方便 而 且 实用 的 Hibernate 开 发 环境 。 还 有 一 章 专门 介绍 
Java 5 的 标注 功能 ， 使 用 标注 ， 而 不 是 用 XML 映射 文件 ， 也 可 以 配置 
HibernatelR AY o 


注意 : 当然 ， 和 其 他 任何 关于 活跃 的 开源 项 目的 图 书 一 样 ， 图 书 
介绍 的 内 容 总 赶不上 开源 项 目的 发 展 ! 附 孙 E 列 出 了 本 书 讨论 的 工具 
的 特定 版 本 以 及 应 对 变化 的 指导 思想 。 


因为 我 们 采用 Maven 来 帮助 下 载 许多 工具 和 库 ， 所 以 使 用 这 本 书 
来 着 手 学 习 和 实践 书 中 的 代码 示例 会 更 加 容易 。 因 为 我 们 希望 你 可 以 
明白 ,没有 什么 理由 不 去 菜 目 实践 一 下 这 些 代 码 示例 。 


在 熟悉 了 Hibernate 的 基础 之 后 ， 第 二 部 分 将 演示 如 何 将 Hibernate 
绑 定 到 其 他 组 件 环境 ， 证 各 种 组 件 互相 配合 ， 以 发 挥 更 大 的 作用 。 


万 变 不 离 其 守 ， 现 在 束 开 始 学 习 吧 。 


我 一 直 很 惊讶 ， 况 然 会 有 这 么 多 免费 而 又 好 用 的 开源 Java 工 具 。 
多 年 前 ， 我 开发 一 个 JSP 的 电子 商务 项 目 时 ， 需 要 一 个 轻 量 级 对 象 /天 
系数 据 库 映射 服务 ， 那 时 还 没有 Hibernate 这 样 的 工具 ， 只 能 自己 构建 
了 一 个 这 样 的 组 件 。 这 个 组 件 经 过 几 年 的 发 展 ， 开 发 出 一 些 很 酷 、 很 
独特 的 功能 。 但 是 在 我 发 现 了 Hibernate 以 后 ， 我 想 在 下 一 个 项 目 中 ， 
就 不 会 再 继续 使 用 自己 熟悉 的 那个 系统 了 (我 当然 对 自己 的 系统 抱 有 
偏爱 ) ， 而 是 会 使 用 Hibernate。 用 过 之 后 ， 你 一 定 会 知道 Hibernate 有 


多 棒 | 


正在 读 这 本 书 的 你 ， 一 定 急于 想 知 道 这 种 功能 强大 而 且 使 用 方便 
的 技术 ， 是 如 何 染 起 连接 Java 对 象 和 关系 数据 库 这 两 个 世界 之 间 的 桥 
RAY! Hibernate 很 好 地 充当 了 这 个 角色 ， 它 并 不 很 复杂 ， 所 以 学 习 起 
来 也 不 困难 。 为 了 展示 这 一 点 ， 本 革 将 要 指导 你 理解 Hibernate 的 用 
法 ， 证 你 看 看 为 什么 Hibernate 会 这 人 么 令 人 激动 。 


之 后 的 章 世 将 介绍 在 更 复杂 环境 〈 例 如 Spring 和 Stripes) 下 ， 把 
Hibernate 作 为 它们 的 组 成 部 分 的 应 用 ， 以 及 它 和 其 他 数据 库 的 配合 使 
用 。 第 1 章 的 目标 是 要 问 你 展示 ， 使 用 Hibernate 构 建 一 个 基本 的 、 目 我 
包含 的 环境 ， 并 且 用 它 完成 真正 的 操作 是 多 么 容易 的 。 


获得 Ant 发 布 版 本 


可 能 有 些 令 人 意外 ， 在 运行 Hibernate 之 前 需要 做 几 件 与 Hibernate 
本 身 无 关 的 事 。 首 先 ， 你 必须 搭建 一 个 开发 环境 ， 以 供 示 例 代码 可 以 
运行 。 也 可 以 为 你 可 能 构建 的 任何 实际 项 目 黄 定 坚实 的 基础 ， 这 将 是 
令 人 高 兴 的 意外 收获 。 


如 果 在 你 的 Java 项 目 中 ， 还 没有 使 用 Ant 去 管理 构建 (build) >M 
试 (test) 、 运 行 (run) 以 及 打包 (package) 的 工作 ， 现 在 束 是 开始 
使 用 Ant 的 好 时 机 。 本 书 的 示例 都 是 Ant 驱 动 的 ， 所 以 ， 你 得 安 闭 一 个 
能 用 的 Ant 才 能 运行 示例 代码 ， 并 验证 在 系统 中 对 代码 做 出 的 修改 ， 这 
才 是 最 佳 的 学 习 方 式 。 


目 先 ， 获 得 Ant 的 二 进 制 发 布 版 本 ， 并 安装 它 。 


为 何在 意 


我 们 选择 使 用 Apache Ant 来 处 理 示例 有 几 个 原因 。Ant 很 方便 ， 而 
且 功 能 强大 ， 它 已 经 成 为 基于 Java 开 发 的 标准 构建 工具 ， 而 且 是 免 
费 、 路 平台 的 工具 。 如 有 果 使 用 Ant， 我 们 的 示例 将 可 以 在 任何 Java 环 境 
中 一 样 地 正常 运行 ， 也 融 是 说 ， 本 书 的 任何 读者 都 不 会 因为 运行 示例 
而 过 到 碾 烦 。 这 也 意味 着 ， 我 们 可 以 少 花 一 点 力气 惑 能够 做 很 多 很 酷 


的 事情 ， 尤 其 是 儿 个 Hibernate 工 具 特意 文 持 Ant 之 后 ， 更 是 如 此 。 我 们 
会 教 你 如 何 利用 这 些 工具 (值得 注意 的 是 ， 最 近 更 复杂 的 Java 项 目 经 
常 使 用 的 是 Maven (H) ， 它 增加 了 很 多 其 他 的 项 目 管理 功能 。 所 以 
我 必须 从 二 者 中 挑选 一 个 ， 本 着 尽 可 能 简单 和 实用 的 原则 ， 我 束 决 定 
继续 使 用 Ant 来 管理 这 些 示例 ) 。 如 采 你 目前 正在 使 用 Maven 作 为 代码 
构建 工具 ， 你 会 注意 到 我 们 使 用 Maven 的 Ant 任 务 (Task) 来 管理 Ant 
构建 的 依赖 天 系 。 虽 然 Maven 的 发 展 势 头 强劲 ， 但 Ant 仍 然 是 目前 Java 
开发 中 使 用 最 广泛 的 构建 工具 。 每 一 章 的 示例 代码 文件 夹 中 也 包含 一 
个 Maven 的 pom.xml 文 件 ， 可 以 用 Maven 进 行 编译 。 在 许多 情况 下 ， 使 
用 Maven Hibernate3 插 件 ，Maven 构 建文 件 提供 的 功能 与 Ant 的 
build.xml 文 件 一 样 。 第 12 章 介绍 了 如 何 用 完整 的 Maven 来 构建 和 部 署 
Hibernate 应 用 程序 的 方法 ， 但 本 书 大 部 分 示例 仍旧 使 用 Ant 作 为 构建 工 
具 ， 同 时 使 用 Maven Ant Task 来 得 找 和 下 载 需 要 的 各 种 库 文件 ， 包 丘 
库 文件 之 间 互 相信 赖 的 文件 。 


为 了 能 够 使 用 这 些 功能 ， 需 要 做 的 第 一 件 事 吏 是 先 安 狼 Ant， 让 它 
可 以 正常 运行 起 来 。 


注意 ， 我 以 前 觉得 奇怪 ， 可 以 用 Make， 为 什么 还 要 用 Ant? 现 
在 ， 我 已 经 明白 用 Ant 来 管理 Java 的 代码 构建 有 多 么 美妙 ， 没 有 Ant 还 
真 的 不 行 。 


DIKE A ti 


Ant 的 二 进 制 发 布 包 可 以 在 http://ant.apache.org/bindownload.cgi 下 
载 。 深 动 网 页 ， 找 到 Ant 的 当前 最 新 版 本 ， 然 后 下 载 适 合 的 压缩 文件 格 
式 。 选 择 一 个 适合 存放 的 位 置 保存 文件 ， 然 后 解压 。 压 缩 文件 展开 的 
目录 束 症 ANT_HOME。 假 如 你 把 压缩 文件 解压 到 日 
录 /usr/local/apache-ant-1.7.0， 你 可 能 会 想 创 建 一 个 符号 链接 (symbolic 
link) 以 方便 使 用 ， 同 时 当 你 升级 到 新 版 本 时 ， 也 可 以 免 去 更 新 环境 
配置 的 矿 烦 : 


/usr/local%ln-s apache-ant-1.7.0 ant 


安装 好 Ant 之 后 ， 需 要 做 一 些 设置 才能 让 它 正 常 工作 。 你 得 将 Ant 
的 bin 目 录 (在 这 个 例子 中 ， 就 是 /usr/local/ant/bin) 添加 到 命令 路 径 
中 。 还 需要 设置 环境 变量 ANT_HOME， 将 其 设 定 为 安装 Ant 的 最 顶级 
目录 (在 这 个 例子 中 ， 就 是 /usr/local/ant) 。 至 于 如 何在 不 同 的 操作 系 
统 中 执行 以 上 这 些 处 理 步骤 ， 如 果 需 要 的 话 ， 可 以 参阅 Ant 的 手册 


(http://ant.apache.org/manual/) 


[1] http://maven.apache.org/. 


检查 Java 版 本 


当然 ， 我 们 假定 你 已 经 安装 好 了 Java software development kit 

(SDK) ° 目前 你 应 该 使 用 Java 5 或 更 新 的 版 本 ， 因 为 新 版 本 的 SDK 会 
提供 一 些 有 用 的 新 功能 。 尽 可 能 使 用 最 新 稳定 版 本 的 SDK, Java 5 或 
Java 6 都 可 以 文 持 本 书 的 所 有 示例 。 用 Java 1.3 也 可 以 使 用 Hibernate2 的 
大 部 分 功能 ， 但 你 得 用 1.3 版 本 的 Java 编 译 器 重新 构建 Hibernate JARX 
件 。 发 布 版 本 越 新 ， 对 Java 版 本 的 要 求 就 越 高 ， 而 且 Java 5 已 经 发 布 很 
长 时 间 了 ， 它 本 身 就 提供 了 很 多 优点 ， 所 以 我 们 没有 必要 为 兼容 早期 
的 JDK 而 花费 时 间 。 我 们 的 示例 都 假定 你 用 的 至 少 是 Java 5， 如 果 使 用 
更 低 版 本 的 JDK， 那 么 就 得 做 大 量 修改 调整 。 运 行 以 下 命令 可 以 查看 
JDK 版 本 : 


%java-version 

java version"1.6.0 02" 

Java (TM) SE Runtime Environment (build 1.6.0_02-b06) 

Java HotSpot (TM) Client VM (build 1.6.0_02-b06, mixed mode, 
sharing) 


你 也 应 该 使 用 官方 发 布 的 Java 版 本 (例如 Sun 或 Apple 发 布 的 版 
本 ) 。 在 编写 本 书 时 ， 我 们 的 技术 审阅 者 发 现 GNU 公 共 授 权 的 “功能 
类 似 ” 的 Java 实 现 并 不 能 正确 运行 这 些 工具 和 示例 代码 。 许 多 Linux 发 
布 版 本 安装 的 默认 Java 环 境 就 是 GNU 的 。 如 果 你 正在 使 用 Linux， 可 能 


需要 自己 下 载 Sun 的 JDK， 并 确保 使 用 的 是 正确 的 版 本 (通过 运行 java- 
version 命 令 ) 。 既 然 Sun 已 经 开放 了 Java 的 源 代 码 ， 硕 望 将 来 这 种 情况 
会 得 到 改善 ， 到 时 候 可 能 在 任何 目 由 软件 版 本 中 都 会 目 带 Sun JRE 和 
JDK 。 不 过 ， 在 那 一 天 实现 以 前 ， 你 必须 目 己 下 载 。 


在 编写 本 书 时 ， 基 于 Debian 的 发 布 版 本 可 以 用 它们 的 安装 管理 工 
具 来 安装 Sun JDK (Ubuntu 的 "Feisty Fawn" 和 "Gutsy Gibbon" 发 行 版 本 
就 自 带 了 JDK 5 和 6) ° Red Hat 系 列 的 发 布 版 本 仍然 需要 直接 从 Sun 
Microsystems 的 网 站 下 载 Java。 具 体 情况 具体 分 析 吧 。 


安装 好 以 后 ， 就 应 该 能 够 启动 Ant 进 行 测试 ， 来 确认 一 切 都 没有 问 


%ant-version 
Apache Ant version 1.7.0 compiled on December 13 2006 


ACT AT A 


H, ARS, MIMEO NARRAR a Be AAS 
例 了 ， 再 以 这 些 示 例 作 为 起 点 ， 去 做 实际 的 Hibernate 项 目 。 


如 果 你 是 Ant 新 手 ， 节 好 爷 人 商 单 阅读 一 下 它 的 手册 来 了 解 Ant 的 工 
作 原 理 和 功能 。 这 样 可 以 让 你 了 解 示 例 中 用 到 的 build.xm] 文 件 是 怎么 
回 事 。 如 果 你 开始 或 已 经 喜欢 上 了 Ant， 想 深入 研究 ， 那 么 你 可 以 仔细 


阅读 它 的 手册 (Ul) ， 或 阅读 O'Reilly 的 《Ant: The Definitive 
Guide) (当然 ， 应 该 先 把 这 本 书 看 完 ) 


其 他 


Eclipse (!?!) ` JBuilder (3!) ` NetBeans! ， 还 是 其 他 Java 
IDE? 咽 ， 你 当然 可 以 使 用 这 些 IDE， 但 是 怎么 把 Ant 整 合 到 IDE 的 构建 
过 程 中 ， 就 是 你 自己 的 事 了 (有 好 几 种 IDE 已 经 支持 Ant， 所 以 你 可 能 
已 经 走 在 前 面 了 ， 对 于 其 他 IDE， 你 可 能 还 需要 跨越 学 习 的 障碍 ) 

如 果 都 行 不 通 ， 你 还 可 以 使 用 IDE 开 发 自己 的 程序 代码 ， 然 后 使 用 我 
们 提供 的 一 个 build 脚 本 ， 从 命令 行 来 调用 Ant 。 


如 果 你 使 用 的 是 Maven， 则 可 以 通过 在 任意 一 章 的 示例 目录 或 最 
顶级 的 examples 目 录 中 执行 mvn eclipse: _ eclipse， 来 生成 Eclipse IDE 项 
目 文件 。 如 果 在 examples 目 了 永 中 运行 mvn eclipse: eclipse, Maven 将 为 
每 一 章 的 示例 生成 一 个 Eclipse 项 目 。 第 12 章 将 详细 介绍 如 何 用 Maven 
来 构建 示例 代码 ， 第 11 章 将 详细 介绍 Hibernate 的 Eclipse 工具 的 用 法 。 


[1] http://ant.apache.org/manual/. 
[2] http://www.eclipse.org/. 
[3] http://www.borland.com/jbuilder/. 


[4] http://www.netbeans.org/. 


一 于 一 


获得 Maven Tasks for Ant 


稍 等 一 下 ， 难 道 我 还 没有 讲 完 用 Ant 构 建 本 书 示例 项 目的 用 法 ? 确 
实 还 没有 说 完 ， 不 过 ， 这 也 并 不 是 全 部 。 虽 然 本 书 以 Ant 作 为 示例 构建 
的 基础 ， 我 们 决定 本 书 应 该 通过 Maven Tasks for Ant 来 演示 一 下 Maven 
优秀 的 依赖 (dependency) 管理 功能 。 本 书 的 最 初版 本 在 这 一 部 分 只 用 
了 几 页 的 篇 幅 来 介绍 如 何 下载 和 管理 一 系列 第 三 方 库 : 包括 从 Jakarta 
Commons Lang 人 到 CGLIB。 如 末 这 些 工 作 由 你 亲 目 来 做 ， 最 少 也 得 化 费 
你 至 贯 上 的 儿 分 钟 的 时 间 ， 而 且说 明 如 何 操作 和 操作 本 吴 费 事 又 楷 琐 。 
本 书 中 ， 我 们 在 build.xml 文 件 中 声明 了 项 目 需要 依赖 的 库 文 件 ， 并 由 
Maven 负 责 下 载 和 管理 这 些 依赖 文件 。 这 样 吏 万 省 了 许多 步骤 和 时 间 。 
好 ， 现 在 葡 开 始 安装 Maven Tasks for Ant ° 


应 该 怎么 做 


有 两 种 方法 来 整合 Maven Tasks for Ant: 第 一 种 方法 是 将 需要 的 
JAR 文 件 放 在 Ant 的 lib 目 录 ， 第 二 种 方法 就 是 在 Ant 的 构建 (build) X 
件 中 用 typedef 声 明 来 包括 antlib 定 义 。 我 们 打算 使 用 前 一 种 方法 ， 将 
maven-ant-tasks-2.0.8.jar 文 件 添加 到 Ant 的 lib 目 录 中 ， 因 为 这 样 对 示例 的 
build.xml 文 件 修改 量 最 少 。 首 先 ， 从 Maven 的 网 站 由 下载 需要 的 JAR 文 


件 ， 在 它 的 首页 上 应 该 可 以 看 到 用 于 下 载 Maven Tasks for Ant 的 链接 
(如 图 1-1 所 示 ) 。 


- Apache Maven Project 
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图 1-1 Maven 网 站 上 Maven Tasks for Ant 的 下 载 链接 


在 编写 本 书 时 ，Maven Tasks for Ant 的 版 本 是 2.0.8。 点 击 Maven 
Tasks for Ant 2.0.8 的 链接 ， 选 择 一 个 镜像 ， 残 可 以 下 载 到 一 个 名 为 
maven-ant-tasks-2.0.8.jar 的 文件 。 将 该 文件 保存 到 本 地 目录 。 


[1] http://maven.apache.org/. 


安装 Maven Tasks for Ant 


接 下 来 ， 将 下 载 好 的 maven-ant-tasks-2.0.8.jar 文 件 复制 到 
ANT_HOME/ib 目 隶 中。 如 有 果 你 从 头 至 尾 按 本 章 的 说 明 来 操作 ， 现 在 
应 该 已 经 下 载 并 安装 好 了 Ant。 还 应 该 设置 一 个 名 为 ANT_HOME 的 环 
境 变量 ， 当 然 ， 你 也 要 了 解 Ant 的 安装 目录 是 什么 。 在 将 maven-ant- 
tasks-2.0.8.jar 复 制 到 ANT_HOME/lib 目 录 以 后 ， 任 何 build.xml 文 件 都 可 
以 包含 相应 的 命名 空间 (namespace) ， 以 使 用 Maven Tasks for Ant ° 


如 果 你 运行 示例 使 用 的 计算 机 上 有 多 个 用 户 ， 而 且 你 没有 将 JAR 
文件 放 到 ANT_HOME/ib 目 录 的 管理 权限 ， 不 必 担 心 ， 你 也 可 以 将 
maven-ant-tasks-2.0.8.jar 文 件 放 在 ~/.antlib 这 个 目录 中 。Ant 也 会 自动 
在 这 个 目录 中 查找 任何 JAR 文 件 。 


在 将 maven-ant-tasks-2.0.8.jar 文 件 复制 到 ANT_HOME/ib 目 录 以 
后 ， 你 应 该 能 够 运行 以 下 命令 ， 以 检查 当前 UNIX 的 类 路 径 (class 


path) 中 是 否 包 含 了 maven-ant-tasks-2.0.8.jar: 


%ant-diagnostics|grep maven|grep bytes 
maven-ant-tasks-2. 0.8.jar (960232 bytes) 


在 Windows 中 ， 运 行 ant-diagnostics， 并 检查 输出 的 类 路 径 包 括 的 


类 库 列 表 中 是 否 包含 了 maven-ant-tasks-2.0.8.jar。 


使 用 HSQLDB 数 据 库 引擎 


Hibernate 文 持 非常 多 的 关系 数据 库 ， 可 能 对 于 下 一 个 项 目 中 你 打 
算 使 用 的 关系 数据 库 ，Hibernate 就 已 经 提供 了 支持 。 我 们 需要 为 示例 
挑选 一 个 数据 库 ， 坟 运 的 是 ， 有 眼前 就 有 一 个 好 的 选择 。 这 是 一 个 免费 
的 、 纯 Java 的 开源 自由 软件 项 目 ， 它 功能 强大 ， 足 以 担当 我 们 的 商业 软 
件 项 目 中 的 数据 存储 支持 系统 。 令 人 惊讶 的 是 ，HSQLDB 也 相当 完善 
而 且 安 装 简单 (简单 到 我 们 可 以 让 Maven 在 新 版 中 负责 它 的 安装 ) ， 所 
以 在 此 讨论 它 很 恰当 (你 是 否 听 说 过 Hypersonic-SQL， 现 在 叫做 
HSQLDB 。Hibernate 的 很 多 说 明文 档 还 沿用 旧 的 名 称 ) 。 


如 果 你 偶然 访问 http://hsql.sourceforge.net/， 发 现 这 个 项 目 好 像 已 经 
停止 了 ， 不 要 惊慌 。 这 是 错误 的 网 址 ， 它 是 HSQLDB 项 目的 前 身 。 图 1- 
2 演示 了 该 项 目 当 前 的 主页 ， 它 还 相当 活跃 。 


为 何在 意 


本 书 示例 是 基于 数据 库 的 ， 每 个 人 部 可 以 下 载 这 些 示 例 ， 方 便 地 
在 此 基础 上 做 试验 ， 其 间 不 需要 转换 任何 SQL 方 言 (dialect) 或 操作 系 
统 命令 ， 就 可 以 和 你 的 数据 库 一 起 使 用 〈 也 许 这 意味 着 你 可 以 节省 下 
一 两 天 的 时 间 ， 不 用 去 人 研究 怎么 下 载 、 安 闭 和 配置 某 种 常用 数据 库 环 


境 ) 。 最 后 ， 如 有 果 你 是 HSQLDB 痢 手 ， 那 么 在 用 过 之 后 感到 印象 深刻 
和 好 奇 心 十 足 的 概率 肯定 很 高 ， 最 终 在 你 自己 的 项 目 中 会 选择 使 用 这 
种 数据 库 ， 正 如 其 项 目 主页 上 所 说 的 : 


HSQLDB 是 用 Java 编 写 的 领先 的 SQL 关系 数据 库 引 警 。 它 提供 了 一 
个 JDBC 驱 动 程序 ， 支 持 ANSI-92 SQL 的 一 个 丰富 子 集 (BNF 树 格 
式 ) ， 以 及 SQL 99 和 2003 增 强 (enhancement) 。 它 提供 了 一 个 小 巧 
(Applet 版 本 的 体积 小 于 100kB) 而 快速 的 数据 库 引 警 ， 以 及 基于 内 存 
和 磁盘 的 两 种 数据 表 ， 文 持 嵌 入 式 和 服务 器 模式 。 此 外 ， 还 包括 了 一 
些 工 具 ， 例 如 微型 Web 服 务 器 、 内 存 查 询 (in-memory query) 和 管理 工 
具 (能 够 作为 Applet 运 行 ) ， 以 及 很 多 演示 例子 。 


应 该 怎么 做 


当 构 建 本 书 的 示例 时 ，Maven Ant Tasks 将 自动 从 位 于 
http://repol.maven.org/maven2/ 的 Maven 仓 库 (repository) 下 载 HSQLDB 
JAR (以 及 其 他 需要 的 JAR) 。 所 以 ， 如 果 你 想 马 上 体验 一 下 ， 可 以 直 
接 转 到 1.7 节 。 和 否则 ， 如 果 你 想 下 载 HSQLDB 供 自己 使 用 ， 或 者 想 查 阅 
它 的 文档 、 在 线 论坛 或 邮件 列表 ， 就 可 以 访问 它 的 项 目 主页 
http://hsqldb.org/。 点击 下 载 当 前 最 新 稳定 版 本 (latest stable version) 的 
链接 (在 编写 本 书 时 ， 最 新 的 版 本 是 1.8.0.7， 如 图 1-2 所 示 ) 。 这 将 打 
开 一 个 典型 的 SourceForge 下 载 页 面 ， 上 面 列 出 了 当前 选中 的 版 本 可 以 


提供 的 下 载 链接 。 选 择 一 个 合适 的 镜像 站 点 ， 就 可 以 开始 下 载 ZIP 文 
人 


注意 :去 吧 ， 下 载 HSQLDB。 哎 蚜 ， 它 们 的 个 头 都 很 小 ! 


pirs 四 Z | +] @ http: 1/hsqidb.org/ 


™ HSQL | hsqdb - 100% Java Database 


database 


me) engine 


Lightweight 100% Java SQL Database Engine 


downloads: 


The new HSQLDB 


è Latest stable 
version: 1.8.8.7. HSQLDB 1.8.0 final is out. A year of soli 


图 1-2 HSQLDB 主 页 上 最 新 的 稳定 版 本 的 链接 
其 他 


Hibernate 对 其 他 数据 库 的 文 持 怎么 样 呢 ? 不 用 担心 ，Hibernate 现 在 
可 以 支持 MySQL、PostgreSQL、Oracle、DB2、Sybase、Informix、 
Apache Derby 等 各 种 数据 库 (本 书 将 在 第 10 章 和 附录 C 中 教 你 如 何 为 不 
同 的 数据 库 指 定 各 自 的 “方言 ”(dialects) ) 。 不 过 ， 如 果 你 真 的 需 


要 ， 可 以 试 着 从 一 开始 就 去 搞 清 楚 怎 么 和 你 最 喜欢 的 数据 库 打 交道 。 
这 也 意味 着 你 在 跟着 本 书 示例 走时 多 花费 一 些 额 外 工夫 ， 同 时 也 会 错 
过 发 现 HSQLDB 美 妙 之 处 的 大 好 机 会 。 


He 


žk {Hibernate Core 


不 需要 再 讲 什么 激励 的 话 吧 ! 你 选择 这 本 书 的 目的 就 是 想 学 习 如 
何 使 用 Hibernate。 或 许 并 不 太 令 人 感到 意外 ，Hibernate 中 为 应 用 程序 提 
供 对 象 /关系 映射 服务 的 核心 部 分 称 为 Hibernate Core。 当 构建 本 书 的 示 
例 时 ，Maven 会 自动 为 你 下 载 Hibernate 和 它 的 所 有 相关 的 依赖 文件 。 即 
便 新 版 的 随 书 代码 示例 可 以 通过 Maven Ant Tasks 来 获取 Hibernate， 你 
也 可 以 亲自 下 载 最 新 的 Hibernate 发 布 版 本 ， 浏 览 它 的 源 代 码 ， 或 只 是 
查看 在 线 文档 、 论 坛 或 其 他 文 持 资 源 。 如 果 你 已 经 准备 好 了 
Hibernate， 则 可 以 跳 过 这 一 闻 ， 直 接 学 习 1.7 节 的 内 容 。 


应 该 怎么 做 


先 访问 Hibernate 的 主页 http://hibernate.org/， 要 获得 其 完整 的 发 布 
版 本 ， 需 要 找到 "Download" 链 接 ， 如 图 1-3 的 左边 所 示 。 
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页 面 上 的 "Binary Releases" 部 分 将 列 出 Hibernate Core 的 推荐 下 载 的 
版 本 (如 果 你 有 足够 的 勇气 ， 可 以 党 试 下 载 “ 开 发 ”(Development) 发 
布 版 本 ， 但 是 最 安全 的 还 是 文 持 下 载 最 新 的 “产品 ”(Production) 发 布 
版 本 ) 。 选 择 好 以 后 ， 点 击 表 格 相应 行 上 的 "Download" 链 接 (如 图 1-4 
EN ° 


Binary Releases 


Package Version Release date Category 

Hibernate Core 3.2.5.ga 31.07.2007 Production wnh 
Hibernate Annotations 3.3.0 GA 20.03.2007 Production era! 
Hibernate EntityManager 3.3.1 GA 29.03.2007 Production Download 
Hibernate Validator 3.0.0 GA 20.03.2007 Production Download 
Hibernate Search 3.0.0 Beta4 1.08.2007 Development Download 
Hibernate Shards 3.0.0 Beta2 02.08.2007 Development Download 
Hibernate Tools 3.2.0 Beta9 13.01.2007 Development Download 
NHibernate 1.2.0.GA 03.05.2007 Production Download 
NHibernate Extensions 1.0.4 24.01.2007 Production Download 
JBoss Seam 1.2.0 Patchi 28.02.2007 Production Download 


Browse all Hibernate downloads, Browse all NHibernate downloads 


图 1-4 ”Hibernate 二 进 制 发 布 版 本 


之 后 会 打开 一 个 SourceForge 的 下 载 页 面 ， 包 含 了 你 刚才 选择 下 载 
的 版 本 ， 以 及 可 供 选 择 的 文档 格式 。 选 择 对 你 最 方便 的 压缩 文件 格式 
进行 下 载 。 下 载 的 文件 名 看 起 来 就 像 hibernate-3.x.ytar.gz 或 hibernate- 
3.x.y.zip 这 样 (在 编写 本 书 时 ， 文 件 名 开始 以 hibernate-3.2.5.ga 命 名 ， 因 
为 Hibernate 3.2.5 的 第 一 个 稳定 版 本 就 是 当前 的 产品 发 布 版 本 ) 。 


选择 一 个 适合 的 地 方 将 文件 解压 。 


在 Hibernate 的 下 载 页 面 ， 也 可 以 看 到 "Hibernate Tools" 部 分 
\Download 链 接 将 打开 一 个 名 为 "JBoss Tools" 的 页 面 ， 不 过 仍然 可 以 在 


上 面 找到 Hibernate Tools) 。 它 们 提供 了 几 个 有 用 的 功能 ， 这 些 功 能 虽 
然 不 是 使 用 Hibernate 的 应 用 程序 所 必须 的 ， 但 是 对 开发 人 员 创 建 菜 些 
应 用 程序 来 说 非常 有 帮助 。 我 们 稍 后 首次 对 Hibernate 进 行 试验 时 ， 将 
使 用 其 中 的 一 个 工具 来 生成 Java 代 码 。 这 个 工具 的 文件 名 看 起 来 应 该 类 
似 于 hibernatetools-3.x.y.zip 的 样子 〈 不 一 定 和 Hibernate 本 身 的 版 本 号 一 
样 ， 通 常 可 以 使 用 的 只 有 beta 版 本 ; 在 Hibernate 的 下 载 页 面 中 ， 位 
"Binary Releases" 下 面 的 "Compatibility Matrix" (兼容 性 和 矩阵) 表格 显 
示 了 Hibernate 各 组 件 之 间 的 相互 兼容 关系 ) 。 


同样 ， 下 载 这 个 文件 ， 将 其 解压 到 存放 Hibemate 的 相关 目录 中 。 


如 果 你 下 载 链接 时 遇 到 麻烦 ， 可 能 是 因为 网 站 正在 维护 ， 处 于 不 
稳定 的 状态 ， 所 以 就 看 不 到 你 要 的 文件 。 如 果真 遇 到 这 样 的 情况 ， 你 
可 以 点 击 "Binary Releases" 方 框 下 面 的 "Browse all Hibernate 
downloads" 链 接 ， 滚 动 页 面 ， 查 找 需 要 下 载 的 内 容 。Hibernate 项 目 非 党 
活跃 ， 所 以 发 生 这 种 情况 比 你 想象 的 要 更 频繁 。 


建立 项 目 层 次 结构 


虽然 起 步 只 是 一 小 步 ， 但 是 ， 当 我 们 开始 设计 数据 结构 ， 并 创建 
用 于 表示 它们 的 Java 类 和 数据 库 表 (database table) ， 再 配合 所 有 配置 
文件 和 控制 文件 ， 将 全 部 内 容 整 合 起 来 以 发 挥 作用 时 ， 我 们 最 后 还 是 
会 得 到 一 大 堆 文 件 。 所 以 ， 起 步 时 我 们 得 先 有 个 民 好 的 组 织 体系 。 从 
前 面 下 载 的 工具 和 相关 的 支持 库 之 间 就 可 以 看 出 ， 有 许多 文件 得 好 好 
加 以 组 织 。 季 运 的 是 ，Maven Ant Tasks 可 以 帮 有 我 们 下 载 和 管理 所 有 的 
外 部 依赖 文件 。 


为 何在 意 


如 琳 你 通过 扩展 本 书 的 示例 而 做 出 了 一 些 很 酯 的 东西 ， 想 将 它们 
转换 成 实用 的 应 用 程序 ， 那 么 你 的 代码 从 一 开始 束 得 有 民 好 的 组 织 。 
更 重要 的 是 ， 如 采 你 按照 这 里 所 说 的 方式 组 织 ， 我 们 在 示例 中 给 你 的 
命令 和 指令 才 会 有 意义 ， 才 能 起 实际 作用 。 书 中 有 很 多 示例 也 彼此 相 
天， 因此 一 开始 走 对 路 有 是 很 重要 的 。 


如 采 你 想 跳 过 这 一 段 去 看 后 面 的 示例 ， 或 者 不 想 输入 一 些 很 长 的 
示例 程序 代码 和 配置 文件 ， 则 可 以 从 本 书 网 站 下 载 各 章 示例 的 “最 


终 ” 版 本 。 这 些 下 载 到 的 文件 的 组 织 方式 的 确 如 这 里 所 述 。 我 们 强烈 建 
议 你 下 载 示例 代码 ， 并 将 它们 作为 你 阅读 本 书 时 的 参考 。 


应 该 怎么 做 


以 下 介绍 如 何 建立 一 个 空 的 项 目 层 次 结构 ， 如 采 你 还 没有 下 载 “ 最 


终 的 ”示例 : 


1. 在 人 硬盘 目录 中 选择 一 个 位 置 ， 作 为 演练 这 些 示 例 的 目录 ， 然 后 创 
建 一 个 新 的 目录 ， 从 现在 开始 ， 我 们 束 称 这 个 目录 为 你 的 项 目 目录 。 


2. 进 入 该 目录 ， 创 建 名 为 src 及 data 的 子 目 录 。Java 源 代码 和 相关 资 
源 的 层次 结构 会 放 在 src 目 录 中 。 我 们 的 构建 过 程 在 编译 代码 时 ， 会 将 
结 采 放 在 编译 时 创建 的 classes 目 隶 下 ， 然 后 把 运行 时 需要 的 任何 资源 都 
复制 到 这 个 目 好 中 。data 目 录用 于 存放 HSQLDB 数 据 库 相 关 的 文件 。 


3. 我 们 打算 创建 的 示例 类 都 将 放 在 com.oreilly.hh (harnessing 
Hibernate) 包 中 ， 而 将 Hibernate 生 成 的 数据 bean 都 放 在 
com.oreilly.hh.data 包 中 ， 以 便 将 它们 与 我 们 手工 创建 的 类 分 离开 来 ， 所 
以 我 们 在 src 目 录 下 创建 这 些 目录 。 在 Linux 和 Mac OS X 上 ， 可 以 使 用 以 
下 命令 来 创建 目录 : 


mkdir-p src/com/oreilly/hh/data 


在 项 目 目 录 中 执行 这 个 命令 ,一 步 束 可 以 完成 目录 的 创建 。 
这 时 ， 你 的 项 目 目 录 结 构 应 该 如 图 1-5 所 示 。 
注意 : 与 本 书 第 1 版 相 比 ， 这 一 版 的 目 孙 结构 要 简单 得 多 ， 似 乎 不 


值得 一 所 ! 
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Al 1-5 最 初 的 项 目 目 孙 结构 


快速 测试 


在 我 们 真正 使 用 Hibernate 来 做 些 有 用 的 工作 以 前 ， 还 应 该 检查 一 
下 其 他 支持 库 是 否 存 在 和 可 以 使 用 。 我 们 先 从 整个 项 目 都 会 用 到 的 Ant 


配置 文件 开始 ， 告 诉 Ant 我 们 把 要 用 的 文件 放 在 哪里 ， 同 时 让 Ant 局 动 
HSQLDB 数 据 库 图 形 界面 。 这 可 以 证 明 Maven Ant Tasks 能 够 找到 并 下 
载 示例 依赖 的 库 ， 可 以 访问 数据 库 图 形 界面 ， 通 过 这 个 界面 我 们 可 以 
查看 Hibernate 为 我 们 创建 的 真实 数据 。 此 时 只 是 作为 一 个 基本 的 完整 
性 检查 ， 以 确认 没有 少 什 么 东西 ， 保 证 我 们 为 继续 学 习 做 好 准备 。 


打开 你 最 喜欢 的 文本 编辑 器 ， 在 项 目 目录 最 顶层 创建 一 个 名 为 
build.xml 的 文件 。 将 例 1-1 的 内 容 输入 到 这 个 文件 中 。 


例 1-1: Ant 构 建 (build) 文件 


<?xml version="1.0"?>@ 

<project name="Harnessing Hibernate 3 (Developer's Notebook 
Second Edition) " 

default="db"basedir="." 

xmlns: artifact="antlib: org.apache.maven.artifact.ant">@ 

<! --Set up properties containing important project directories- 
->6 

<property name="source.root"value="src"/> 

<property name="class.root"value="classes"/> 

<property name="data.dir"value="data"/> 

<artifact: dependencies pathId="dependency.classpath">® 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency > 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 

version="3.2.0.beta9a"/ > 

<dependency groupId="org.apache.geronimo.specs" 

artifactId="geronimo-jta_1.1_spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 

</artifact: dependencies > 

<! --Set up the class path for compilation and execution-- > 

<path id="project.class.path">® 

<! --Include our own classes, of course--> 


<pathelement location="${class.root}"/>@ 

<! --Add the dependencies classpath-- > 

<path refid="dependency.classpath"/>@ 

</path> 

<target name="db"description="Runs HSQLDB database management UI 
against the database file--use when application is not running"> 


<java classname="org.hsqldb.util.DatabaseManager" 
fork="yes"> 

<classpath refid="project.class.path"/> 

<arg value="-driver"/> 

<arg value="org.hsqldb.jdbcDriver"/> 

<arg value="-url"/> 

<arg value="jdbc: hsqldb: ${data.dir}/music"/> 
<arg value="-user"/> 

<arg value="sa"/> 

</java> 

</target> 

</project > 


输入 时 要 小 心 那 些 标点 符号 ， 对 于 自 结束 的 (self-closing) XML 
标签 更 要 小 心 〈 是 %>”， 而 不 是 “> ”) 。 如 果 输 入 错误 ， 代 价 就 是 运 
行 Ant 时 得 到 解析 错误 的 信息 。 如 采 你 不 想 手工 输入 这 些 文件 的 内 容 ， 
可 以 从 本 书 网 站 下 载 这 些 文件 。 如 果 你 正在 阅读 的 是 PDF 电子 文档 ， 也 
可 以 草 切 和 粘贴 代码 ， 但 需要 去 掉 一 些 无 关 的 排版 字符 。 


如 采 你 以 前 没有 看 过 Ant 构 建文 件 ， 以 下 简单 介绍 可 以 帮助 你 熟悉 
Eo (如 果 你 想 碍 看 更 多 的 细 市 ， 可 以 访问 文档 


http://ant.apache.org/manual/index.html ° ) 


@ 第 1 行 只 是 声明 这 个 文件 的 类 型 是 XML。 如 果 你 以 前 在 其 他 情况 
下 用 过 XML， 就 应 该 很 习惯 这 种 文件 格式 ， 如 果 没 有 ， 那 就 再 看 一 次 


(Ant 目 前 不 需要 这 一 行 ， 但 大 多 数 XML 解 析 需 都 需要 ， 因 此 养 成 这 种 
习惯 是 一 件 好 事 ) 。 


@Ant 的 构建 文件 总 包含 一 个 project 定 义 。default 属 性 用 于 告诉 
Ant， 如 果 在 命令 行 没 有 指定 要 构建 任何 目标 (target) ，Ant 要 默认 构 
建 哪个 目标 (后 面 会 定义 ) 。basedir 属 性 用 于 指定 所 有 路 径 计 算 都 对 
应 于 哪个 目 隶 。 我 们 可 以 不 指定 这 个 属性 ， 因 为 在 默认 情况 下 忌 是 将 
build.xml 所 在 的 目录 作为 相对 目录 的 基本 目 好 但 十 明确 指定 类 似 的 基 
本 设置 是 一 种 好 习惯 。 在 这 个 project 元 素 中 需要 注意 的 一 个 重要 事情 
是 ，xmlns: artifact 是 专门 为 Maven Ant Tasks 提 供 的 命名 空间 定义 。 该 
命名 空间 定义 使 用 了 artifact 前 级 ， 这 样 束 可 以 在 构建 文件 中 使 用 Maven 
Ant Tasks 了 (后面 有 具体 的 使 用 方法 ) 。 


日 接 下 来 的 几 行 定义 了 3 个 属性 ， 我 们 可 以 在 构建 文件 的 其 他 部 分 
中 ， 通 过 名 称 来 引用 相应 的 属性 。 基 本 上 ， 我 们 在 此 是 为 项 目 中 各 个 
部 分 用 到 的 重要 目 孙 定义 其 符号 名 称 。 这 样 做 并 非 必要 (尤其 是 目录 
名 称 非 常 简 单 时 ) ， 不 过 这 也 是 一 种 好 习惯 。 至 少 ， 如 果 你 得 修改 这 
些 目 录 中 的 某 个 目录 时 ， 只 需要 修改 构建 文件 中 的 一 个 地 方 ， 而 不 用 
进行 迷 琐 的 搜索 和 替换 操作 。 


@artifact: dependencies 元 素来 源 于 Maven Ant Tasks， 你 (以 及 
Ant) 可 以 通过 artifact， 前 级 判断 出 这 一 点 。 在 这 个 元 素 中 ， 我 们 定义 
了 一 套 依赖 ， 项 目 需要 它们 才 可 以 编译 和 执行 。 这 些 依赖 对 应 于 Maven 


2 Repository (位 于 http://repol.maven.org/maven2) 中 央 仓 库 中 的 JAR 文 
件 (或 其 他 生成 文件 ) 。 每 个 artifact (工件 ) 由 一 个 groupId 、artifactId 
以 及 version 号 进行 惟一 标识 。 在 这 个 项 目 中 ， 我 们 需要 依靠 
Hibernate、HSQLDB、Log4J 以 及 JTA API ° “Maven Ant Tasks 遇 到 这 
些 依赖 声明 时 ， 就 会 从 Maven 2 中 央 仓 库 中 按照 需要 将 每 个 artifact 下 载 
到 你 的 本 地 Maven 2 仓库 中 ({E~/.m2/repository He F) 。 如 果 你 对 这 
一 区 段 的 配置 内 容 还 没有 什么 感觉 ， 大 可 不 必 担 心 ， 在 稍 后 儿 页 的 内 
容 中 ， 我 们 将 深入 探索 相关 的 细节 。 如 果 需 要 ， 你 可 以 对 这 一 区 段 的 
配置 作出 修改 〈 只 要 修改 version 值 ) ， 以 便 使 用 这 些 依赖 的 程序 包 的 
更 新 版 本 (因为 在 本 书 交 付 印 刷 之 后 ， 可 能 会 有 新 版 本 推出 ) 。 不 过 
你 可 以 放心 ， 本 书 印刷 出 版 后 ， 书 中 的 例子 将 一 定 能 够 正常 运行 ， 因 
为 不 论 你 什么 时 候 研究 这 些 例子 ，Maven 仓 库 可 以 确保 我 们 测试 过 的 版 
本 总 是 可 用 的 。 我 们 之 所 以 在 本 书 中 采用 Maven Ant Tasks， 这 也 是 很 
大 的 一 部 分 原因 。 


@class-path 区 段 的 用 途 很 明确 。 这 个 功能 正 是 我 每 次 做 Java 项 目 
时 ， 几 乎 总 要 为 其 配置 一 个 简单 的 Ant 构 建文 件 的 原因 。 无 论 做 什么 规 
模 的 项 目 ， 总 是 需要 将 很 多 第 三 方程 序 库 放 到 类 路 径 中 ， 而 且 还 得 确 
保 编 译 时 和 运行 时 的 配置 都 完全 一 样 。Ant 使 得 这 一 工作 变 得 很 简单 。 
我 们 定义 了 一 个 path， 有 点 像 一 个 属性 ， 但 是 它 知 道 应 该 如 何 解析 、 收 
集 文件 和 目录 信息 。 我 们 的 类 路 径 包含 classes 目 录 ， 经 过 编译 的 Java 文 
件 束 放 在 这 个 目录 中 〈 这 个 目录 现在 还 不 存在 ;下 一 章 会 在 构建 处 理 


中 多 增加 一 个 步骤 以 创建 它 ) ， 此 外 ， 也 包含 与 artifact: dependencies 
元 素 中 列 出 的 依赖 相对 应 的 所 有 JAR 文 件 。 这 正 是 编译 和 运行 项 目 所 需 
要 的 一 切 。 


对 于 Java 路 径 和 类 层次 结构 的 理解 和 处 理 来 说 ，Ant 是 一 个 很 棒 的 
工具 ， 值 得 我 们 深入 学 习 。 


@ 这 一 行 的 标点 符号 有 点 令 人 迷惑 ， 但 实际 上 可 以 划分 成 具有 和 意 
义 的 几 个 部 分 。Ant 可 以 使 用 置换 (substitution) 机 制 ， 将 变量 值 插入 
到 规则 中 。 当 你 看 到 像 "${class.root}" 这 样 的 语句 时 ， 这 表示 “寻找 名 为 
class.root 的 属性 值 ， 用 这 个 值 来 置换 这 里 的 字符 串 ”。 所 以 ， 根 据 前 面 
对 class.root 的 定义 ， 置 换 的 结果 就 好 像 是 在 这 里 输入 了 : <pathelement 
location="classesV>。 那 么 ， 为 什么 要 这 么 做 呢 ? 这 和 是 为 了 可 以 在 整个 
构建 文件 中 共享 某 个 属性 值 ， 这 样 ， 如 果 需 要 修改 相关 的 配置 ， 则 只 
需要 关注 一 个 地 方 就 可 以 了 。 在 大 型 的 复杂 项 目 中 ， 这 种 组 织 和 管理 
是 很 重要 的 。 


@ 我 们 在 前 面 看 到 的 artifact: dependencies 元 素 使 用 它 的 pathId 属 
性 ， 将 所 有 声明 的 依赖 组 装 到 一 个 名 为 dependency.classpath 的 路 径 中 。 
这 里 ， 我 们 将 dependency.classpath 的 内 容 附 加 到 project.class.path 中 ， 以 
便 在 编译 和 运行 时 可 以 找到 我 们 用 Maven 取 回 的 依赖 包 。 


@@ 最 后 ， 这 些 前 期 工作 做 好 以 后 ， 我 们 就 能 够 定义 第 一 个 构建 目 
标 了 。 一 个 目标 其 实 束 是 一 系列 任务 ， 为 了 完成 项 目的 目标 ， 必 须 按 
顺序 执行 任务 。 典 型 的 构建 目标 就 是 做 些 类 似 于 编译 代码 、 运 行 测 
试 、 为 发 布 而 打包 文件 等 各 种 事情 。 可 以 从 Ant 内 建 的 一 组 丰富 的 功能 
中 选择 任务 ， 而 像 Hibernate 这 样 的 第 三 方 工具 则 可 以 扩展 Ant， 以 便 捉 
供 它 们 目 己 的 任务 ， 这 在 下 一 章 就 会 看 到 。 我 们 的 第 一 个 构建 目标 是 
db， 它 会 运行 HSQLDB 的 图 形 界面 ， 让 我 们 查看 示例 数据 库 。 我 们 可 
以 用 Ant 内 建 的 java 任 务 来 完成 这 项 工作 ， 它 会 为 我 们 运行 Java 虚 拟 
机 ， 并 配置 好 我 们 需要 的 启动 类 、 参 数 (argument) 以 及 属性 。 


就 此 例 而 言 ， 我 们 想 要 调用 的 类 是 

org.hsqldb.util.DatabaseManager， 在 HSQLDB JAR 中 可 以 找到 这 个 类 
(Maven Ant Tasks 将 为 我 们 管理 这 个 依赖 ) 。 将 fork 属 性 设置 为 "yes"， 
这 是 告诉 Ant 使 用 另 一 个 单独 的 虚拟 机 ， 而 不 是 默认 的 虚拟 机 ， 因 为 默 
认 虚 拟 机 得 花费 比较 长 的 时 间 ， 而 且 通 常 没有 这 个 必要 。 在 这 个 例子 
中 ， 这 一 点 很 重要 ， 因 为 我 们 想 让 数据 库 管 理 器 GUI 一 直 保持 运行 ， 直 
到 我 们 关 掉 它 ， 但 是 ， 如 果 在 Ant 自 己 的 VM 中 运行 ， 就 达 不 到 这 样 的 
效果 。 


如 果 你 的 数据 库 GUI 弹 出 后 ， 残 马上 消失 ， 请 再 次 检查 你 的 java 任 
务 的 fork 属 性 。 


E 有 关 之 前 已 经 配置 好 的 类 
路 径 信息 的 〈 这 是 我 们 所 有 的 构建 目标 都 得 使 用 的 配置 属性 ) 。 然 
后 ， 我 们 为 数据 库 管 理 锋 提供 了 很 多 参数 ， 告 诉 它 使 用 标准 的 
HSQLDB JDBC 张 动 程 序 ， 到 哪儿 去 找 数据 库 ， 以 及 使 用 的 用 户 名 是 什 
么 。 我 们 在 data 目 好 中 指定 了 一 个 名 为 music 的 数据 库 。 这 个 日 如 当前 
还 是 空 的 ， 所 以 HSQLDB 会 在 我 们 第 一 次 使 用 时 创建 这 个 数据 库 。 新 
数据 库 默 认 的 “系统 管理 员 ” 用 户 名 是 sa， 最 初 的 配置 是 一 开始 不 需要 密 
码 。 显 然 ， 如 果 你 计划 让 数据 库 在 网 络 上 也 可 以 使 用 (HSQLDB 能 够 
做 得 到 ) ， 就 需要 设置 密码 。 我 们 不 需要 做 这 些 花 哨 的 事 ， 所 以 现在 
先 不 用 理会 其 他 配置 。 


OK， 让 我 们 试 一 下 吧 ! 保存 好 这 个 文件 ， 在 你 的 顶级 项 目 目 录 
(build.xml 所 在 的 目录 ) 的 命令 提示 行 中 输入 以 下 命令 : 


ant db 


(或 者 ， 因 为 我 们 将 db 设置 为 默认 的 构建 目标 ， 你 也 可 以 只 输入 
ant) 在 Ant 开 始 运 行 以 后 ， 如 果 一 切 顺 利 ， 你 会 看 到 像 下 面 这 样 的 输出 
结果 : 


Buildfile: build.xml 

Downloading: hsqldb/hsqldb/1.8.0.7/hsqldb-1.8.0.7.pom 

Transferring OK 

Downloading: org/hibernate/hibernate/3.2.5.ga/hibernate- 
3.2.5.ga.pom 

Transferring 3K 

Downloading: net/sf/ehcache/ehcache/1.2.3/ehcache-1.2.3.pom 


Transferring 19K 

Downloading: commons-logging/commons-logging/1.0.4/commons- 
logging-1.0.4.pom 

Transferring 5K 

Downloading: commons-collections/commons-collections/2.1/commons - 
collections- 

2.1.pom 

Transferring 3K 

Downloading: asm/asm-attrs/1.5.3/asm-attrs-1.5.3.pom 

Transferring OK 

Downloading: dom4j/dom4j/1.6.1/dom4j-1.6.1.pom 

Transferring 6K 

Downloading: antlr/antlr/2.7.6/antlr-2.7.6.pom 

Transferring OK 

Downloading: cglib/cglib/2.1_3/cglib-2.1_3.pom 

Transferring OK 

Downloading: asm/asm/1.5.3/asm-1.5.3.pom 

Transferring OK 

Downloading: commons-collections/commons - 
collections/2.1.1/commons-collections- 

2.1.1. pom 

Transferring OK 

Downloading: org/hibernate/hibernate- 
tools/3.2.0.beta9a/hibernate-tools- 

3.2.0.beta9a.pom 

Transferring 1K 

Downloading: org/hibernate/hibernate/3.2.0.cr5/hibernate- 
3.2.0.cr5.pom 

Transferring 3K 

Downloading: freemarker/freemarker/2.3.4/freemarker-2.3.4.pom 

Transferring OK 

Downloading: org/hibernate/jtidy/r8-20060801/jtidy-r8- 
20060801.pom 

Transferring OK 

Downloading: org/apache/geronimo/specs/geronimo- 
jta_1.1_spec/1.1/geronimo- 

jta_1.1_spec-1.1.pom 

Transferring 1K 

Downloading: org/apache/geronimo/specs/specs/1.2/specs-1.2.pom 

Transferring 2K 

Downloading: org/apache/geronimo/genesis/config/project- 
config/1.1/project - 

config-1.1.pom 

Transferring 14k 

Downloading: 
org/apache/geronimo/genesis/config/config/1.1/config-1.1.pom 

Downloading: 
org/apache/geronimo/genesis/config/config/1.1/config-1.1.pom 


Downloading: 
org/apache/geronimo/genesis/config/config/1.1/config-1.1.pom 

Transferring OK 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 
1.1.pom 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 
1.1.pom 

Downloading: org/apache/geronimo/genesis/genesis/1.1/genesis- 
1.1.pom 

Transferring 6K 

Downloading: org/apache/apache/3/apache-3.pom 

Downloading: org/apache/apache/3/apache-3.pom 

Downloading: org/apache/apache/3/apache-3.pom 

Transferring 3K 

Downloading: 10g4j/10g4j/1.2.14/10g4j-1.2.14.pom 

Transferring 2K 

Downloading: org/hibernate/hibernate- 
tools/3.2.0.beta9a/hibernate-tools- 

3.2.0.beta9a. jar 

Transferring 352K 

Downloading: org/hibernate/jtidy/r8-20060801/jtidy-r8- 
20060801. jar 

Transferring 243K 

Downloading: commons-collections/commons - 
collections/2.1.1/commons-collections- 

2.1.1.jar 

Transferring 171K 

Downloading: commons-logging/commons-logging/1.0.4/commons- 
logging-1.0.4.jar 

Transferring 37K 

Downloading: antlr/antlr/2.7.6/antlir-2.7.6.jar 

Transferring 433K 

Downloading: org/apache/geronimo/specs/geronimo- 
jta_1.1_spec/1.1/geronimo- 

jta_1.1_spec-1.1.jar 

Transferring 15K 

Downloading: net/sf/ehcache/ehcache/1.2.3/ehcache-1.2.3.jar 

Transferring 203K 

Downloading: asm/asm/1.5.3/asm-1.5.3.jar 

Transferring 25K 

Downloading: freemarker/freemarker/2.3.4/freemarker-2.3.4.jar 

Transferring 770K 

Downloading: dom4j/dom4j/1.6.1/dom4j-1.6.1.jar 

Transferring 306K 

Downloading: asm/asm-attrs/1.5.3/asm-attrs-1.5.3.jar 

Transferring 16K 

Downloading: cglib/cglib/2.1_3/cglib-2.1_3.jar 

Transferring 275K 


Downloading: hsqldb/hsqldb/1.8.0.7/hsqldb-1.8.0.7.jar 

Transferring 628K 

Downloading: 10g4j/1l0g4j/1.2.14/1log4j-1.2.14.jar 

Transferring 358K 

Downloading: org/hibernate/hibernate/3.2.5.ga/hibernate- 
3.2.5.ga.jar 

Transferring 2202K 

db: 


一 大 堆 下 载 文件 信息 表明 Maven Ant Tasks 完 成 了 它 的 任务 ， 为 我 
们 下 载 了 指定 的 文件 (包括 HSQLDB 和 Hibernate) 以 及 所 有 依赖 的 库 
文件 。 这 一 过 程 可 能 需要 花费 一 段 时 间 才 能 完成 (取决 于 网 络 连接 的 
速度 和 服务 器 的 情况 ) ， 但 是 它 只 进行 一 次 。 下 一 次 再 运行 Ant 时 ， 
Maven Ant Tasks 就 会 注意 到 你 的 本 地 库 中 已 经 包含 了 所 有 这 些 文件 ， 
就 会 默认 继续 执行 其 他 需要 完成 的 任务 了 。 


在 所 有 下 载 完 成 以 后 ，Ant 会 打印 输出 "db:"， 表 明 它 正 开始 执行 你 
请 求 的 目标 。 一 会 儿 ， 你 应 该 会 看 到 HSQLDB 的 图 形 界面 ， 如 图 1-6 所 
示 。 我 们 的 数据 库 现 在 还 没有 什么 东西 ， 所 以 ， 除 了 命令 能 运行 以 
外 ， 没 有 其 他 内 容 。 窗 口 左 上 部 的 树 形 视图 是 数据 库 中 可 以 浏览 的 各 
种 数据 表 和 字段 。 就 目前 而 言 ， 只 要 确认 最 上 层 是 否 
为 "jdbc:hsqldb:data/music" 就 可 以 了 。 


GB jdbc hsaldb data/ music 
& Propenies 


图 1-6 HSQLDB 数 据 库 管理 器 界面 


如 有 果 你 喜欢 ， 可 以 浏览 一 下 菜单 ， 但 不 要 对 数据 库 进行 任何 修 
改 。 在 完成 以 后 ， 选 择 "File" ~ "Exit"， 窗 口 就 会 关闭 ， 同 时 Ant 将 报告 
以 下 信息 : 


BUILD SUCCESSFUL 
Total time: 56 seconds 


"Total time" 是 你 运行 这 个 数据 库 管理 器 程序 所 用 的 时 间 ， 所 以 其 值 
是 变化 的 (刚才 我 们 在 Ant 的 构建 文件 中 为 java 任 务 设置 了 fork 属 性 ， 所 
以 直到 关闭 数据 库 以 前 ，Ant 会 一 直 等 待 ，。 此 时 ， 如 果 你 查看 data 目 
录 ， 你 会 发 现 HSQLDB 已 经 创建 了 一 些 文件 来 保存 数据 库 信息 : 


%ls data 
music.log music.properties music.script 


你 甚至 可 以 查看 这 些 文件 的 内 容 。 和 大 多 数 数据 库 系 统 不 同 ， 
HSQLDB 是 以 人 类 可 读 的 格式 来 存储 数据 的 。.properties 文 件 中 包含 一 
些 基本 设置 ， 而 .script 文 件 中 的 数据 则 以 SQL 语 句 的 形式 保存 。.log 文 
件 用 于 当 应 用 程序 朋 溃 或 没有 正常 关闭 数据 库 而 强行 退出 时 ， 可 以 重 
新 构建 一 致 的 数据 库 状 态 。 现 在 ， 你 在 这 些 文件 中 看 到 的 都 是 基本 和 定 
义 ， 都 是 默认 值 ， 以 后 我 们 开始 创建 数据 表 并 添加 数据 时 ， 束 可 以 看 
到 这 些 文件 会 有 所 变化 。 这 也 可 以 作为 一 种 有 用 的 调试 手段 来 进行 基 
本 的 完整 性 检查 ， 甚 至 比 局 动 图 形 界面 执行 查询 还 要 快 。 


注意 : 能 够 直接 读 取 HSQLDB 数 据 库 文件 的 内 容 ， 是 一 件 诡异 但 
有 趣 的 事 。 


de F 


目前 我 们 已 经 成 功 运行 了 第 一 个 示例 ， 建 立 了 我 们 的 项 目 构建 文 
件 ， 现 在 解释 Ant 如 何 取 回 这 个 项 目 必需 的 依赖 文件 。 我 们 再 查看 一 下 
示例 的 build.xml 文 件 中 的 artifact: dependencies 元 素 〈 如 例 1-2 所 示 ) ° 


例 1-2: artifact: dependencies 元 素 


<artifact: dependencies pathId="dependency.classpath"> 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency > 


<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="org.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1_spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 
</artifact: dependencies > 


如 果 你 以 前 从 没有 用 过 Maven， 这 个 例子 看 起 来 非常 令 人 费解 。 我 
们 先 定义 一 些 术 语 。 首 先是 artifact。 一 个 artifact 就 是 项 目 生成 的 一 个 文 
件 ， 它 可 以 是 任意 类 型 的 文件 一 web 应 用 程序 的 WAR 文 件 、 企 业 应 用 
程序 的 EAR 文 件 或 是 简单 的 JAR 文 件 。 对 于 我 们 的 用 途 来 说 ， 我 们 使 用 
的 是 JAR artifact， 如 果 你 不 在 dependency 元 素 中 指定 它 ， 其 默认 的 类 型 
就 是 jar， 非 党 方便 。 


artifact 有 4 个 属性 :groupId、artifactId、version 以 及 type。 例如， 我 
们 需要 org.hibernate 组 内 的 hibernate artifact， 其 版 本 是 3.2.5.ga， 文 件 类 
型 是 jar。Maven 将 使 用 这 些 标识 符 在 位 于 http://repol.maven.org/maven2/ 
的 中 央 Maven 2 库 中 来 查找 定位 适当 的 依赖 文件 。 使 用 这 些 值 ，Maven 
将 通过 以 下 模式 来 尝试 定位 Hibernate 的 JAR: <repositoryUrl> /< 


groupld > /< artifactId > /< version > / < artifactId > - < version > . < type 
> ， 其 中 ，groupId 中 的 点 号 “.” 将 转换 成 URL 的 路 径 分 隔 符 。 使 用 这 样 
的 模式 ， 就 可 以 定位 Hibernate 和 HSQLDB 依 赖 的 JAR 文 件 了 ， 如 例 1-3 
所 示 。 


例 1-3: 项 目 依 赖 文 件 的 URL 


http://repo1.maven.org/org/hibernate/hibernate/3.2.5.ga/hibernate 
-3.2.5.ga.jar 
http://repo1.maven.org/hsqldb/hsqldb/1.8.0.7/hsqldb-1.8.0.7.jar 


在 build.xml 文 件 中 ， 我 们 没有 在 Hibernate 依 赖 声 明 中 包含 JTA 依 
赖 。 这 是 因为 Hibernate 库 使 用 的 是 一 个 非 自由 (nonfree) 的 JAR 文 件 ， 
所 以 Maven 2 公共 库 中 没有 这 个 文件 。 这 个 项 目 没 有 使 用 Sun 提 供 的 标 
准 JTA API JAR， 而 是 使 用 了 Apache Geronimo 项 目 创建 的 JTA API ° 
geronimo-jta_1.1_spec 是 Java Transaction API. 的 一 个 自由 的 开源 实现 版 
本 。 这 个 蔡 换 是 通过 在 Hibernate 3.2.5.ga 的 依赖 声明 中 使 用 exclusion 元 
素来 实现 的 ， 并 随后 明确 声明 了 需要 使 用 Geronimo JTA spec 1.1。 


好 了 ， 我 们 已 经 介绍 了 Maven Ant Tasks 如 何 从 Maven 库 中 取 回 依赖 
文件 ， 但 是 ， 如 果 已 经 下 载 好 了 这 些 依赖 文件 ， 又 会 怎么 样 呢 ? Maven 
Ant Tasks 将 所 有 的 依赖 文件 都 下 载 到 一 个 本 地 的 Maven 库 中 ， 由 Maven 
负责 维护 这 个 本 地 库 ， 使 其 结构 与 远程 Maven 库 的 结构 保持 一 致 。 当 需 
要 检查 某 个 artifact 时 ，Maven 先 检查 本 地 库 ， 如 果 本 地 库 没 有 这 个 
artifact 时 ， 再 从 远程 库 中 请 求 该 artifact。 这 意味 着 ， 如 果 同 时 有 20 个 项 
目 都 引用 了 同一 版 本 的 Hibernate， 从 Maven 远 程 库 中 只 下 载 一 次 
Hibernate 的 依赖 artifact， 所 有 20 个 项 目 都 会 引用 保存 在 本 地 Maven 库 中 
的 同一 个 副本 。 那 么 ， 这 个 不 可 思议 的 本 地 Maven 库 是 放 在 哪里 呢 ? 最 
简单 的 回答 就 是 ， 在 build.xml 文 件 中 添加 一 个 目标 。 在 原来 的 Ant 
build.xml 的 末尾 添加 以 下 目标 ， 如 例 1-4 所 示 。 


例 1-4: 打印 输出 依赖 类 的 路 径 


<target name="print-classpath"description="Show the dependency 
class path"> 

<property name="class.path"refid="dependency.classpath"/ > 

<echo>${class.path}</echo> 

</target> 


运行 这 个 目标 ， 将 生成 以 下 输出 结 末 : 


%ant print-classpath 

Buildfile: build.xml 

print-classpath: 

[echo]~\.m2\repository\commons -logging\commons-logging\1.0.4\ 
commons-logging-1.0.4.jar; \ 
~\.m2\repository\dom4j\dom4j\1.6.1\dom4j-1.6.1.jar; \ 
~\.m2\repository\cglib\cglib\2.1_3\cglib-2.1_3.jar; Na.. 


运行 该 目标 ， 输 出 结果 会 随 你 正在 使 用 的 操作 系统 的 不 同 而 有 所 
变化 ， 不过， 你 可 以 看 到 ， 依 赖 类 的 路 径 都 引用 了 本 地 Maven 库 。 在 运 
行 Windows XP 的 计算 机 上 ， 这 一 路 径 可 能 位 于 C: \Documents and 
Settings\Username\.m2\repository; 在 运行 Windows Vista 的 计算 机 上 ， 这 
一 路 径 则 可 能 位 于 C: \Users\Username\.m2\repository; 而 在 Unix 和 


Macintosh 上， 该 路 径 将 会 是 ~/.m2/repository 目 了 永 。 


你 也 可 能 会 注意 到 ， 在 类 路 径 中 列 出 的 依赖 文件 的 数目 要 比 我 们 
在 build.xml 的 artifact: dependency 元 素 中 声明 的 多 。 这 些 额 外 的 依赖 就 
是 所 谓 的 可 传递 的 依赖 (transitive dependency) ， 它 们 是 你 明确 声明 的 
依赖 文件 所 需要 的 依赖 。 例 如 ，Hibernate 需 要 依赖 CGLib、EHCache、 


Commons Collections 以 及 其 他 程序 库 。 对 Maven 的 详细 介绍 超出 了 本 书 
讨论 的 范围 ， 我 在 这 里 只 对 Maven Ant Tasks 如 何 为 你 的 项 目 构造 整套 
依赖 结构 提供 一 些 提示 。 如 果 在 构建 好 一 个 示例 后 ， 你 查看 一 下 本 地 
Maven 库 ， 你 会 注意 到 在 每 个 JAR artifact 祁 边 会 有 一 个 扩展 名 为 .pom 的 
项 目 对 象 模型 (POM) 文件 。POM 是 Maven 构 建 系统 和 仓库 的 基础 ， 
每 一 个 POM 搞 述 了 一 个 artifact 和 它 的 依赖 。Maven Ant Tasks 使 用 这 种 
元 数据 (metadata) 来 构造 一 个 描述 依赖 传递 关系 的 树 状 结构 。 换 句 话 
Ui, Maven Ant Tasks 并 不 只 是 负责 下 载 Hibernate， 它 们 还 负责 下 载 
Hibernate 依 赖 的 所 有 文件 。 


你 实际 需要 知道 的 是 它 的 工作 原理 就 是 这 样 的 。 


接 下 来 做 什么 


感谢 Maven Ant Tasks， 有 了 它 ， 就 不 用 像 本 书 的 最 初版 本 那样 亲 
自 查 找 、 下 载 、 解 压 软件 ， 并 组 织 好 它们 。 现 在 你 可 以 从 一 个 更 高 的 
起 点 来 开始 使 用 Hibernate， 在 下 一 章 中 你 可 以 看 到 ， 我 们 的 进展 会 非 
常 快速 。 你 将 看 到 Hibernate 已 经 为 你 写 好 了 Java 代 码 ! 数据 库 模 式 
(database schema) 也 好 像 是 从 天 而 降 一 样 (或 者 ， 至 少 是 来 自 于 产生 
Java 程 序 代码 的 同一 个 XML 映射 表 ) ! 真正 的 数据 表 和 数据 也 会 出 现 
在 HSQLDB 管 理 器 界面 中 (或 者 ， 至 少 是 示范 数据 ) |! 


MERGANE? 咽 ， 和 你 以 前 的 开发 方法 相 比 如 何 ? 我 们 继 
续 研 究 下 去 ， 把 Hibernate 的 强大 功能 唤醒 吧 。 


为 何 无 法 工作 


如 有 果 你 没有 看 到 数据 库 管 理 器 窗口 ， 而 是 出 现 了 错误 信息 ， 那 么 
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层次 结构 出 错 ; 是 否 是 因为 访问 Internet 困 难 ， 而 不 能 从 Maven 库 下 载 
到 依赖 文件 ， 或 是 其 他 什么 原因 。 再 次 确认 所 有 东西 都 安排 妥当 ， 并 
且 按 照 前 面 介绍 的 方式 正确 地 安装 。 如 采 是 目 己 输入 的 文件 有 问题 ， 
可 以 考虑 下 载 示 例 程序 。 


我 们 已 经 开始 使 用 Hibernate T ° PIME, RATEI P ANA 
进 的 脚步 ， 站 在 一 定 高 度 观 察 一 下 Hibernate 的 全 用 ， 以 免 迷 失 在 
Hibernate 32 IAC A CIE 2, EIR AY © fRJavaz 
的 面向 对 象 语言 提供 了 强大 而 方便 的 抽象 层 ， 可 以 在 运行 时 以 对 象 

(类 的 实例 ) 的 形式 来 处 理 信 息 。 这 些 对 象 之 间 可 以 通过 各 种 方式 链 
接 起 来 ， 除 了 它们 本 喘 所 拥有 的 原始 数据 外 ， 还 可 以 包含 规则 和 行 
为 。 但 是 ， 当 程序 运行 结束 时 ， 所 有 对 象 都 会 消失 得 无 影 无 踩 。 


对 于 那些 在 程序 多 次 运行 之 间 需 要 保存 下 来 的 信息 ， 或 者 是 需要 
在 不 同 程序 或 系统 之 间 共 至 的 信息 ， 实 践 证 明 关 系数 据 库 是 难以 击败 
的 最 佳 解决 方案 。 关 系数 据 库 具有 高 度 的 可 伸缩 性 、 可 靠 性 、 高 效 性 
以 及 灵活 性 。 所 以 ， 我 们 需要 有 一 种 方式 可 以 把 信息 从 SQL 数据 库 中 
提取 出 来 ， 再 将 其 较 换 成 Java 对 象 ， 反 之 亦 然 。 


实现 这 一 功能 有 许多 不 同 的 方法 ， 从 完全 手工 的 数据 库 设计 和 编 
码 ， 到 高 度 自动 化 的 工具 ， 都 有 相应 的 解决 方案 。 这 个 普遍 性 问题 就 
是 人 们 所 谓 的 对 象 /关系 数据 库 映 射 (Object/Relational Mapping) 问 
题 ， 而 Hibernate 正 是 Java 中 一 种 轻 量 级 的 O/R 映 射 服务 。 


所 谓 “ 轻 量 级 ”(lightweight) 是 指 ， 和 其 他 一 些 可 用 的 工具 相 比 ， 
Hibernate 的 设计 相当 易于 学 习 和 使 用 ， 同 时 对 系统 资源 的 需求 也 在 合 
理 的 范围 内 。 虽 然 如 此 ，Hibernate 还 是 设法 达到 了 用 途 广泛 而 义 有 技 
术 的 深度 。Hibernate 的 设计 者 对 实际 项 目 中 需要 完成 的 工作 进行 了 细 
致 的 研究 ， 并 对 这 些 工作 提供 民 好 的 支持 。 


Hibernate 的 使 用 方法 有 很 多 种 ， 这 要 取决 于 你 开始 时 看 手 的 对 
象 。 如 果 需 要 交互 的 数据 库 已 经 存在 ， 则 可 以 用 Hibernate 的 一 些 工具 
对 现 有 的 数据 库 模式 (schema) 进行 分 析 ， 以 此 作为 映射 (mapping) 
的 起 点 ， 之 后 ， 它 再 帮助 你 编写 一 些 用 于 表示 那些 数据 的 Java 类 。 如 
果 你 已 经 有 了 Java 类 ， 并 希望 把 这 些 类 的 实例 中 的 数据 保存 在 数据 库 
中 ， 则 可 以 从 这 些 Java 类 开始 ， 用 Hibernate 工 具 生 成 相应 的 映射 文 
件 ， 再 生成 用 于 创建 数据 库 表 的 模式 脚本 。 


在 本 书 中 ， 我 们 将 要 带领 你 从 一 个 全 新 的 项 目 开始 ， 没 有 现成 的 
Java 类 或 数据 库 表 ， 让 Hibernate 帮 助 你 生成 这 些 类 和 数据 库 表 。 当 像 
这 样 从 头 做 起 时 ， 最 佳 的 切入 点 就 是 二 者 之 间 的 一 个 中 间 点 ， 也 就 古 
我 们 打算 在 程序 对 象 和 存储 这 些 对 象 的 数据 表 之 间 使 用 的 映射 的 抽象 
定义 。 附 录 E 就 如 何 深 入 学 习 Hibernate 列 举 了 一 些 建议 ， 如 果 你 愿意 
使 用 Eclipse， 第 11 章 还 得 介绍 如 何在 Eclipse 中 使 用 Hibernate ° 


对 于 那些 已 经 习惯 处 理 Java 对 象 ， 而 对 抽象 模式 比较 阳 生 的 开发 
人 员 来 说 ， 他 们 在 熟悉 这 种 方法 之 前 ， 可 能 会 遇 到 些小 麻烦 ， 或 许 只 


征 为 一 个 外 部 的 XML 文件 费 神 而 已 。 第 7 章 会 演示 如 何 使 用 Java 5 的 标 
注 ， 在 你 的 数据 模型 类 中 组 入 映射 信息 。 搞 清楚 基于 XML 的 映射 是 很 
重要 的 ， 所 以 我 们 就 从 它 开始 学 习 Hibernate 。 


在 我 们 的 示例 中 ， 我 们 将 处 理 一 个 数据 库 ， 用 它 来 驱动 一 个 应 用 
程序 界面 ， 用 户 可 以 保存 许多 个 人 音乐 收藏 数据 ， 还 可 以 方便 地 进行 
搜索 、 浏 览 和 欣赏 音乐 《第 1 章 最 后 创建 了 一 些 数据 库 文 件 ， 从 其 中 的 
文件 名 你 或 许可 以 猜 到 这 些 吧 ) 。 
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传统 的 Hibernate 使 用 XML 文档 来 维护 Java 类 和 关系 数据 库 表 之 间 
的 颈 射 和 关系。 这 种 映射 文档 设计 为 可 由 开发 人 员 阅 读 和 手工 编辑 的 。 
你 也 可 以 用 图 形 化 的 CASE (Computer Aided Software Engineering, + 
算 机 辅助 软件 工程 ) 工具 (例如 Togethor (''!) 、Rose (P1) 以 及 
Poseidon (P!) ) 来 建立 表示 数据 模型 的 UML 图 表 ， 再 将 这 些 图 表 输 
入 到 AndroMDA ('4!) (http:/www.andromda.org/) 中 ， 就 可 以 生成 
相应 的 Hibernate 映 射 文档 。 前 面 提 到 的 Hibernate Tools 包 也 可 以 为 你 提 


供 这 些 功能 (第 11 章 将 会 演示 在 Eclipse 中 使 用 它们 是 多 么 容易 ) 。 


要 牢记 ，Hibernate 及 其 扩展 工具 可 以 让 你 用 其 他 方式 进行 开发 。 
如 果 你 已 经 有 了 Java 类 或 数据 ， 也 可 以 从 它们 开始 着 手 。 我 们 还 会 学 


习 一 种 更 新 的 方法 一 Hibernate 标 注 ， 它 可 以 让 你 完全 脱离 开 XML 映 射 
文档 ， 这 种 方法 将 在 第 7 章 加 以 介绍 。 


这 里 ， 我 们 先 手 工 编写 XML 映射 文档 ， 这 是 一 种 相当 实用 的 方 
法 。 我 们 要 为 曲目 (Track) 对 象 创建 映射 文件 。 曲 目 就 是 各 个 可 以 单 
独 欣 党 的 乐曲 ， 或 是 可 以 收录 在 乐曲 集 或 演 玛 列表 中 的 乐曲 。 甫 先 ， 
我 们 要 记录 曲目 的 标题 、 存 储 实际 音乐 的 文件 路 径 、 它 的 播放 时 间 、 
曲目 添加 进 数 据 库 的 日 期 以 及 播放 曲目 应 该 用 的 音量 (不同 乐曲 在 录 
制 时 采用 的 音量 不 见得 相同 ， 总 用 预 设 的 默认 音量 播放 不 一 定 合 
iG) ° 


为 什么 选择 这 个 示例 


你 可 能 根本 不 需要 创建 一 个 新 的 系统 来 保存 音乐 曲目 ， 但 在 建立 
这 个 示例 的 映射 文档 时 所 涉及 的 概念 和 处 理 过 程 ， 可 以 在 你 的 实际 项 
目 中 加 以 应 用 。 


应 该 怎么 做 


注意 ;你 可 能 会 觉得 这 一 映射 文件 中 包含 了 太 多 的 信息 。 正 如 你 
所 看 到 的 ， 确 实 如 此 ， 可 以 用 它 来 创建 很 多 有 用 的 项 目 资 源 。 


打开 你 喜欢 用 的 文本 编辑 器 ， 在 前 面 1.7 节 中 创建 的 
src/com/oreilly/hh/data 目 录 下 创建 一 个 名 为 Track.hbm.xml 的 文件 (如果 
你 跳 过 了 这 一 节 ， 就 得 回去 再 阅读 一 下 1.7 节 ， 因 为 本 示例 要 依赖 当时 
所 建立 的 项 目 目 录 结 构 和 工具 ) 。 在 该 映射 文档 中 输入 例 2-1 所 示 的 内 


dk 


容 。 
例 2-1: 曲目 对 象 的 映射 文档 : Track.hbm.xml 


<?xml version="1.0"?> 

<! DOCTYPE hibernate-mapping PUBLIC"-//Hibernate/Hibernate 
Mapping DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">@ 

<hibernate-mapping > 

<class name="com.oreilly.hh.data.Track"table="TRACK" >@ 

<meta attribute="class-description">® 

Represents a single playable track in the music database. 

@author Jim Elliott (with help from Hibernate) 

</meta> 

<id name="id"type="int"column="TRACK_ID">@ 

<meta attribute="Scope-set">protected</meta> 

<generator class="native"/>® 

</id> 

<property name="title"type="string"not-null="true"/>@ 

<property name="filePath"type="sString"not-null="true"/> 

<property name="playTime"type="time">@ 

<meta attribute="field-description" >Playing time</meta> 

</property> 

<property name="added"type="date" > 

<meta attribute="field-description" >When the track was created 
</meta> 

</property> 

<property name="volume"type="Short"not-null="true" > 

<meta attribute="field-description" >How loud to play the track 
</meta> 

</property> 

</class> 

</hibernate-mapping > 


@ 最 前 面 的 3 行 是 有 效 的 XML 文档 所 必需 的 预定 义 部 分 ， 用 于 声 
明 该 XML 文档 符合 Hibernate 映 届 使 用 的 文档 类 型 定义 。 实 际 的 映射 内 


容 将 位 于 hibernate-mapping 标 签 内 部 。 


@ 我 们 正在 为 一 个 类 (com.oreilly.hh.data.Track) 定义 它 的 映射 ， 
这 个 类 的 名 称 和 包 和 名 与 已 经 创建 的 文件 的 名 称 和 路 径 是 一 致 的 。 但 这 
种 关系 不 是 必需 的 ， 可 以 在 一 个 映射 文档 中 为 任意 数量 的 类 定义 它们 
的 映射 ， 为 映射 文件 起 任意 名 字 ， 并 把 它 放 在 任何 地 方 ， 只 要 告诉 
Hibernate 坊 么 找到 这 个 文件 束 可 以 了 。 不 过 ， 根 据 映 里 到 的 类 来 命名 
映射 文件 ， 并 将 它 和 映射 到 的 类 放 在 一 起 ， 这 一 惯例 市 来 的 好 处 是 : 
当 需 要 使 用 这 个 类 时 ，Hibernate 能 够 目 动 定位 该 映射 文档 。 当 类 的 数 
量 不 多 时 ， 这 样 可 以 简化 Hibernate 的 配置 和 使 用 。 


如 采 映 喘 类 的 数量 比较 多 ， 那 么 你 可 能 会 布 望 使 用 XML 格式 的 
Hibernate 配 置 文件 ， 再 从 这 个 配置 文件 中 引用 所 有 的 映射 文档 ， 而 不 
必 像 本 书 第 1 版 那样 ， 在 所 有 示例 源 代码 中 再 涉及 它们 (从 下 一 章 开 

人 ， 束 会 看 到 我 们 换 用 了 这 种 新 方法 。 此 外 ， 在 使 用 基于 XML 的 配 
置 文件 时 ， 将 各 个 映射 文档 和 Hibernate 配 置 文件 放 在 一 起 ， 而 不 是 和 
映射 类 分 散 地 保存 ， 这 样 做 更 有 意义 。 


在 class 元 素 的 开始 标签 中 ， 我 们 指定 这 个 类 要 保存 在 一 个 名 为 
TRACK 的 数据 库 表 中 。 


@meta 标 签 并 不 会 直接 影响 映射 ， 相 反 ， 这 个 标签 为 使 用 其 他 不 
同 工 具 而 提供 额外 的 信息 。 在 这 个 例子 中 ， 通 过 将 attribute 属 性 值 指定 
为 "class-description"， 我 们 告诉 Java 代 码 生成 工具 : 需要 为 Track 类 关 
联 什么 样 的 JavaDoc 文 本 信息 。 这 个 标签 完全 是 可 选 的 ， 在 本 章 稍 后 
的 “生成 Java 类 ”一 市 中 ， 就 会 看 到 包 仿 JavaDoc 信 息 的 结果 。 


@ 映 冉 内 容 的 其 他 部 分 用 于 设 定 我 们 想 保 存 到 数据 库 中 的 信息 ， 
也 就 是 类 的 属性 以 及 数据 库 表 中 与 之 相关 的 字段 。 虽 然 我们 在 介绍 这 
个 例子 时 没有 所 及， 但 每 个 曲目 对 象 都 需要 一 个 id 属性 。 按 照 数 据 库 
的 最 佳 实践 标准 ， 我 们 应 该 用 一 个 没有 意义 的 代理 键 (surrogate key, 
一 个 没有 语义 含义 的 值 ， 只 用 来 标识 特定 的 数据 行 ) 。 在 Hibernate 
中 ，key/id ( 键 /属性 ) 之 间 的 映射 关系 是 用 id 标签 来 设置 的 。 我 们 准 
备 使 用 一 个 int 类 型 的 值 把 id 保存 在 数据 库 字 段 Track_ id 中。 这 里 义 包 侣 
了 一 个 meta 标 签 ， 用 于 和 Java 代 码 生 成 右 进 行 通信 ， 告 诉 它 这 个 id 属 性 
的 set 方 法 应 该 具有 protected 类 型 的 访问 权限 ， 因 为 应 用 程序 代码 本 号 
没有 必要 去 修改 曲目 对 象 的 ID 。 


@generator 标 签 用 于 设置 Hibernate 如 何 为 新 的 实例 创建 其 id 值 CE 
意 ， 该 标签 与 普通 的 对 象 /关系 映射 操作 有 关 ， 而 与 Java 代 码 生 成 郝 无 
关 ， 而 且 也 不 经 滑 使 用 代码 生成 器 ;generator 要 比 可 选 的 meta 标 签发 
挥 更 多 的 功能 ) 。 在 这 个 标签 中 可 以 从 中 选择 很 多 不 同 的 ID 生成 党 
略 ， 甚 至 可 以 编写 目 己 的 策略 。 在 这 个 例子 中 ， 我 们 告诉 Hibernate 使 


用 底层 数据 库 最 自然 的 主键 生成 方法 ( 稍 后 我 们 会 看 到 Hibernate 如 何 
知道 我 们 正在 使 用 什么 数据 库 ) 。 在 HSQLDB 中 ， 会 采用 一 个 标识 


(identity) FE ° 


@ 在 ID 之 后 ， 我 们 只 列举 出 关心 的 各 种 曲目 属性 。title 是 一 个 字符 
串 属性 ， 而 且 不 能 为 null。filePath 也 有 同样 的 属性 设置 ， 而 除了 
volume 以 外 ， 其 他 属性 都 可 以 为 null 。 


@playTime 是 time 类 型 ，added 是 date 类 型 ， 而 volume 是 short 类 型 。 
最 后 三 个 属性 用 了 男 一 个 新 的 meta 属 性 "field-description"， 用 它 为 单个 
属性 指定 JavaDoc 文 本 信息 ， 但 目前 的 代码 生成 器 对 此 还 有 些 限制 。 


该 映 出 文件 严格 而 简练 地 指定 了 我 们 需要 表达 的 音乐 曲目 的 各 种 
数据 ， 而 且 Hibernate 也 可 以 处 理 这 种 映射 格式 。 接 下 来 我 们 融 看 看 
Hibernate 实 际 上 是 如 何 处 理 的 (Hibernate 能 够 表示 更 为 复杂 的 信息 ， 
包括 表示 对 象 之 间 的 关系 ， 我 们 将 在 接 下 来 的 几 章 中 加 以 介绍 。 附 录 
E 也 讨论 了 一 些 与 深入 学 习 本 书 内 容 相关 的 方法 ) 


[1] http://www.borland.com/us/products/together/index.html. 
[2] http://www-306.ibm.com/software/awdtools/developer/thechnical/. 
[3] http://genteware.com/index.php. 


[4] http://www.andromda.org/. 


生成 Java 类 


有 关 数 据 库 、Java 类 以 及 它们 之 间 的 


我 们 的 映射 文件 中 包含 的 是 
它 来 帮助 我 们 创建 数据 库 表 和 和 Java 类。 首 


RRRS o n AH 
先 ， 我 们 来 看 看 Java 类 。 


DIATE A ti 


你 在 第 1 章 安 装 的 Hibernate Tools 中 包含 一 个 工具 ， 可 以 生成 匹配 
映射 文档 规定 的 Java 源 代码 。 只 要 用 一 个 Ant 任 务 就 能 方便 地 在 Ant 的 
构建 文件 中 调用 这 一 工具 。 编 辑 build.xml， 把 例 2-2 中 的 黑体 部 分 添加 
HER ° 


例 2-2: Ant 构 建文 件 (已 经 为 生成 Java 代 码 而 做 了 相应 的 更 新 ) 


<?xml version="1.0"?> 

<project name="Harnessing Hibernate 3 (Developer's Notebook 
Second Edition) " 

default="db"basedir="." 

xmins: artifact="antlib: org.apache.maven.artifact.ant"> 

<! --Set up properties containing important project directories- 
-> 

<property name="source.root"value="src"/> 

<property name="class.root"value="classes"/> 

<property name="data.dir"value="data"/> 

<artifact: dependencies pathId="dependency.class.path"> 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 


<exclusion groupId="javax.transaction"artifactId="jta"/> 
</dependency > 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 
version="3.2.0.beta9a"/> 

<dependency groupId="org.apache.geronimo.specs" 
artifactId="geronimo-jta_1.1_spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 
</artifact: dependencies > 


<! --Set up the class path for compilation and execution--> 
<path id="project.class.path"> 
<! --Include our own classes, of course--> 


<pathelement location="${class.root}"/> 

<! --Add the dependencies classpath-- > 

<path refid="dependency.class.path"/> 

</path> 

<! --Teach Ant how to use the Hibernate Tools--> 

<taskdef name="hibernatetool"@ 

classname="org.hibernate.tool.ant.HibernateToolTask" 

classpathref="project.class.path"/> 

<target name="db"description="Runs HSQLDB database management 
UI 

against the database file--use when application is not 
running" > 

<java classname="org.hsqldb.util.DatabaseManager" 

fork="yes"> 

<classpath refid="project.class.path"/> 

<arg value="-driver"/> 

<arg value="org.hsqldb.jdbcDriver"/> 

<arg value="-url"/> 

<arg value="jdbc: hsqldb: ${data.dir}/music"/> 

<arg value="-user"/> 

<arg value="sa"/> 

</java> 

</target> 

<! --Generate the java code for all mapping files in our source 
tree--=> 

<target name="codegen"@ 

description="Generate Java source from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration> 

<fileset dir="${source.root}"> 

<include name="**/*.hbm.xmLl"/ > 

</fileset > 

</configuration> 

<hbm2java/> 

</hibernatetool> 

</target> 

</project > 


我 们 在 构建 文件 中 新 添加 了 一 个 taskedf 〈 任 务 定义 ) 元 素 ， 以 及 
一 个 用 于 创建 文件 的 target 元 素 : 


@ 这 一 行 的 任务 定义 教 给 Ant 一 个 新 技巧 : 它 告诉 Ant 如 何 使 用 
Hibernate Tools 中 包含 的 hibernate tool 任 务 《有 个 专门 的 类 为 该 目的 提 
供 帮 助 ) 。 注 意 ， 它 也 指定 了 调用 这 个 工具 时 所 需 的 类 路 径 ， 并 引用 
project.calss.path 定 义 (这 个 定义 包含 了 Maven Ant Tasks 为 我 们 管理 的 
所 有 依赖 文件 ) 。 当 Ant 需 要 使 用 hibernate 工 具 时 ， 通 过 这 种 办 法 ， 就 
可 以 找到 它们 。 


@codegen 构 建 目 标 使 用 Hibernate Tools (hbm2java) 模式 来 运行 
Hibernate 的 代码 生成 右 ， 处 理 src 源 代码 目录 中 找到 的 任何 映射 文件 ， 
生成 相应 的 Java 源 代码 。"**/*.hbm.xml" 这 样 的 匹配 模式 (pattem) 是 
说 “在 指定 目录 或 其 任何 子 目录 下 (无 论 有 多 深 ) ， 任 何以 .hbm.xml 结 
尾 的 文件 ”。 


让 我 们 先 试 一 下 吧 ! 从 你 的 项 目 目 录 的 命令 行 中 ， 输 入 以 下 命 


ant codegen 


你 应 该 看 到 类 似 以 下 内 容 的 输出 〈 假 设 你 运行 过 前 面 章节 中 ant db 
示例 ， 运 行 那个 例子 会 下 载 所 有 必需 的 依赖 文件 ， 如 采 你 还 没有 运行 


过 那个 例子 ， 则 此 时 在 下 载 这 些 依赖 文件 时 ， 会 多 显示 许多 行 信 


A) 


Buildfile: build.xml 

codegen: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]i.task: hbm2java (Generates a set of.java files) 

[hibernatetool]log4j: WARN No appenders could be found for 
logger 

(org.hibernate.cfg.Environment) . 

[hibernatetool]log4j: WARN Please initialize the log4j system 
properly. 

BUILD SUCCESSFUL 

Total time: 2 seconds 


以 上 提示 信息 大 致 说 的 是 ， 我 们 在 第 1 章 配 置 构建 文件 要 安装 
log4j， 但 还 没有 建立 它 需 要 的 配置 文件 ， 我 们 将 在 2.3 市 介绍 解决 这 一 
问题 的 办 法 。 现 在 ， 如 果 你 去 看 看 src/com/orielly/hh/data 目 隶 ， 束 会 发 
现 出 现 了 一 个 名 为 Trackjava 的 狐 文 件 ， 其 内 容 如 例 2-3 所 示 。 


例 2-3: 根据 Track 映 射 文 档 生 成 的 Java 源 代码 


package com.oreilly.hh.data; 

//Generated Sep 2, 2007 10: 27: 53 PM by Hibernate Tools 3.2.0.b9 
import java.util.Date; 

JER 

*Represents a single playable track in the music database. @® 
*@author Jim Elliott (with help from Hibernate) 

xx / 

public class Track implements java.io.Serializable{ 

© 

private int id; 

private String title; 

private String filePath; 

JER 


*Playing time 


aes 

private Date playTime; 

SER 

*When the track was created 
4 

private Date added; 

JER 

*How loud to play the track 
*/ 

private short volume; 

© 

public Track () { 

} 


public Track (String title, String filePath, short volume) { 

this.title=title; 

this.filePath=filePath; 

this .volume=volume:; 

} 

public Track (String title, String filePath, Date playTime, Date 
added, 

short volume) { 

this.title=title; 

this.filePath=filePath; 

this.playTime=playTime; 

this .added=added; 

this .volume=volume; 

} 

public int getId () { 

return this.id; 

} 

protected void setId (int id) {0 

this .id=id; 

} 

public String getTitle () { 

return this.title; 


public void setTitle (String title) { 
this.title=title; 

} 

public String getFilePath () { 

return this. filePath; 


public void setFilePath (String filePath) { 
this.filePath=filePath; 

} 

SRR 

**Playing time 


ars 
public Date getPlayTime () { 
return this.playTime; 


public void setPlayTime (Date playTime) { 
this.playTime=playTime; 


} 

SER 

**when the track was created 
*/ 

public Date getAdded () { 
return this.added; 


} 
public void setAdded (Date added) { 
this .added=added; 


} 

/** 

**How loud to play the track 

*/ 

public short getVolume () { 

return this.volume; 

public void setVolume (short volume) { 
this .volume=volume; 


} 

} 

这 个 文件 是 怎么 生成 的 ? Ant 会 找 出 源 代码 树 中 所 有 以 .hbm.xml 结 
尾 的 文件 (目前 只 有 一 个 ) ， 把 它们 传 给 Hibernate 的 代码 生成 器 ， 该 
FREE Bia Se TER AT SCE, RE BM BEE Track BRAY SC EP 8 RE BR 
味 要 求 的 Java 类 文件 。 很 明显 ， 这 个 工具 可 以 为 我 们 市 省 很 多 时 间 ， 
并 帮 我 们 完成 一 些 重复 性 的 工作 |! 


注意 : Hibernate 可 以 为 我 们 克 省 许多 时 间 并 完成 很 多 党 琐 的 操 
IE o BAR, BNE SWE ee LR o 


比较 生成 的 Java 源 代码 和 映射 文件 中 的 映射 规定 〈 例 2-1) ， 你 会 
有 所 收获 。 源 代码 以 相应 的 包 (package) 声明 作为 开始 ， 对 于 
hbm2java 而 言 ， 根 据 映射 文件 中 指定 的 完全 限定 的 类 名 ， 束 可 以 容易 
地 确定 正确 的 包 名 : 


@ 类 级 的 JavaDoc 看 起 来 应 该 很 眼熟 ， 因 为 它 来 自 映 射 文档 中 meta 


标签 的 "class-description"。 


@ 字 段 声 明 是 来 目 于 映射 文档 中 定义 的 id 和 property 标 签 。 源 代码 
中 所 用 到 的 Java 类 型 都 生源 目 于 映射 文档 中 的 property 类 型 声明 。 学 习 
有 大 Hibernate 文 持 的 全 部 值 类 型 ， 可 以 参阅 附录 E 提 到 的 资源 。 目 前 
而 言 ， 映 里 文件 内 的 类 型 和 已 生成 的 代码 内 的 Java 类 型 两 者 间 的 关系 
应 该 相当 明确 。 


信子 段 声 明之 后 是 三 个 构造 画 数 的 定义 。 第 一 个 构造 钞 数 是 创建 
实例 时 不 用 任何 参数 (如 果 想 让 你 的 类 能 够 作为 标准 的 bean 来 使 用 ， 
例如 在 JSP (Java Server Page) 内 使 用 ， 这 是 这 种 数据 类 非常 常见 的 用 
法 ) ; 第 二 个 构造 函数 只 需要 提供 映射 文档 中 标明 不 得 为 null 的 值 ; 
最 后 一 个 构造 琐 数 是 为 所 有 属性 赋值 。 注 意 ， 这 些 构造 男 数 都 没 设 置 
id 属性 的 值 ， 当 我 们 从 数据 库 把 对 象 取出 或 者 第 一 次 将 对 象 数据 插入 
数据 库 时 ，Hibernate 负 责 帮 有 我 们 做 这 件 事 。 


OR, seld O 方法 的 访问 类 型 是 protected， 与 id 的 映射 配置 的 
要 求 是 一 样 的 。 后 面 的 getter 和 setter 方 法 就 没什么 特别 之 处 了 ， 都 是 些 
照 本 宣 科 式 的 程序 代码 〈 我 们 都 写 过 无 数 次 了 ) ， 这 就 是 让 Hibernate 
工具 为 我 们 生成 这 些 代码 的 妙 处 所 在 。 


如 果 你 想 使 用 Hibernate 生 成 的 代码 作为 起 点 ， 并 在 生成 的 Java 类 
中 添加 某 些 业务 逻辑 或 其 他 功能 ， 一 定 要 记 住 ， 你 所 做 出 的 修改 在 下 
一 次 运行 代码 生成 占 时 ， 部 会 被 “悄悄 ”地 丢弃 。 在 这 样 的 项 目 中 ， 你 
需要 确保 手工 修改 过 的 类 不 会 被 任何 Ant 的 构建 目标 任务 重新 生成 。 一 
种 第 用 的 技巧 是 ， 把 需要 手工 修改 的 类 扩展 成 Hibernate 生 成 的 类 。 这 
也 是 为 什么 我 们 要 将 映射 生成 的 Java 类 隔离 到 它们 自己 的 代码 包 和 子 
目录 申 的 原因 之 二 有 * 


虽然 此 例 中 Hibernate 为 我 们 生成 了 数据 类 ， 但 需要 指出 的 一 个 要 
点 是 ，Hibernate 创 建 的 getter 和 setter 方 法 不 仅仅 是 为 了 样子 好 看 。 对 于 
你 需要 持久 化 的 任何 属性 ， 在 持久 类 中 都 必须 具有 getter 和 setter 方 法 。 
这 是 因为 Hibernate 底 层 的 持久 化 架构 是 通过 反射 机 制 来 访问 JavaBeans 
风格 的 属性 的 。 如 果 你 不 希望 类 的 属性 是 公共 (public) 的 ， 它 们 可 以 
不 必 是 public 的 (即使 属性 被 声明 为 protected 或 private, Hibernate 还 是 有 
办 法 取得 这 些 属 性 的 值 ) ， 但 它们 必须 具有 访问 器 和 修改 器 方法 ， 即 
getter (访问 器 ) 和 setter (Mas) 方法 。 这 一 点 也 是 优秀 的 面向 对 象 


设计 应 该 遵循 的 准则 Hibernate 团队 和 希望 把 实际 的 实例 变量 (instance 
variable) 的 实现 细节 与 底层 持久 化 保存 机 制 完 全 分 离开 来 。 


编制 数据 库 Schema 


刚才 真 简单 ， 对 吧 ? 根据 映射 来 创建 数据 库 表 也 差不多 是 这 样 ， 
你 会 很 恰 快 地 学 习 下 去 。 和 代码 生成 一 样 ， 只 要 利用 映 喘 文 件 ， 几 乎 
所 有 工作 都 做 完了 。 剩 下 的 融 是 设置 和 运行 schema 生 成 工具 。 


应 该 怎么 做 


第 一 步 是 我 们 在 第 1 章 间 接 提 到 的 一 些 事情 。 我 们 必须 告诉 
Hibernate， 我 们 要 使 用 什么 数据 库 ， 这 样 ，Hibernate 才 知道 应 该 使 用 什 
么 SQL 方言 ”(dialect) 。 没 错 ，SQL 是 标准 ， 但 每 种 数据 库 系统 在 标 
准 SQL 基 础 上 ， 还 都 有 各 自在 某 些 方面 的 扩展 ， 有 一 套 会 影响 到 实际 
应 用 的 特定 功能 和 限制 。 为 了 解决 这 一 现实 问题 ，Hibernate 提 供 了 一 
组 类 来 封装 常见 数据 库 环境 的 独特 功能 ， 这 些 类 位 于 
org.hibernate.dialect 包 中 。 你 只 需要 告诉 Hibernate 想 要 使 用 哪 一 种 数据 
E (如 果 你 要 使 用 的 数据 库 是 Hibernate 目 前 尚未 支持 的 ， 也 可 以 自行 
实现 必需 的 SQL 方言 ) 。 


在 我 们 的 这 个 例子 中 ， 使 用 的 是 HSQLDB 数 据 库 ， 所 以 要 用 
HSQLDialect。 配 置 Hibernate 最 简单 的 方法 就 是 创建 一 个 名 为 


hibernate.properties 的 属性 配置 文件 ， 再 将 它 放 在 项 目 类 路 径 的 根 目录 
中 。 在 src 目 录 的 顶层 创建 这 个 文件 ， 将 例 2-4 的 内 容 放 进去 。 


例 2-4: 设置 hibernate.properties 的 内 容 


hibernate. 
hibernate. 
hibernate. 
hibernate. 


dialect=org.hibernate.dialect.HSQLDialect 


connection. 
connection. 
connection. 


driver_class=org.hsqldb.jdbcDriver 
url=jdbc: hsqldb: data/music 
username=sa 


connection. 
connection. 


hibernate. 
hibernate. 


password= 
shutdown=true 


除了 设置 要 使 用 的 SQL 方言 以 外 ， 这 个 属性 配置 文件 也 会 告诉 

Hibernate 如 何 使 用 封装 在 HSQLDB 数 据 库 JAR 文 件 内 的 JDBC 驱 动 程序 
来 建立 数据 库 的 连接 ， 而 且 数 据 应 该 放 在 data 目 录 下 名 为 music 的 数据 
库 中 。 在 经 过 第 1 章 的 实践 以 后 ， 对 用 户 名 和 空 密 码 (事实 上 ， 所 有 都 
是 这 个 值 ) 应 该 都 很 熟悉 了 。 最 后 ， 我 们 告诉 Hibernate， 当 处 理 完成 
后 ， 应 该 显 式 关闭 数据 库 连接 ， 这 是 在 艇 入 模式 下 处 理 HSQLDB 的 一 
个 artifact。 如 果 不 关闭 连接 的 话 ， 当 工具 退出 时 ， 对 数据 库 的 修改 就 不 
一 定 会 写 入 到 数据 库 中 ， 所 以 你 的 数据 库 模 式 总 是 莫名 其 妙 地 为 空 。 


如 前 所 述 ， 你 也 可 以 使 用 XML 格 式 来 保存 配置 信息 ， 但 就 此 处 的 
简单 需求 而 言 ， 这 样 做 没有 什么 价值 。 我 们 将 在 第 3 章 介绍 XML 格 式 的 
配置 方法 。 


你 也 可 以 把 .properties 文 件 存放 在 其 他 地 方 ， 并 提供 不 同 的 文件 名 
称 ， 或 者 以 完全 不 同 的 方式 把 这 些 设置 属性 传递 给 Hibernate。 但 这 里 
是 Hibernate 寻 找 配 置 文 件 的 默认 位 置 ， 因 此 这 是 个 最 方便 的 路 径 (或 
者 ， 我 猜想 也 是 需要 最 少 运行 时 配置 的 方法 ) 。 


我 们 也 需要 在 Ant 构 建文 件 中 加 入 一 些 新 项 ， 如 例 2-5 所 示 ， 在 
build.xml 文 件 末 尾 的 </project> 结束 标签 前 增加 了 一 些 新 的 目标 。 


例 2-5: 生成 schema 所 需要 的 Ant 构 建文 件 


<! --Create our runtime subdirectories and copy resources into 
them- - > 

<target name="prepare"description="Sets up build structures">@ 

<mkdir dir="${class.root}"/> 

<! --Copy our property files and O/R mappings for use at 
runtime- -> 

<copy todir="${class.root}"> 

<fileset dir="${source.root}"> 

<include name="**/*.properties"/> 

<include name="**/*.xm1l"/>@ 

</fileset > 

</copy> 

</target> 

<! --Generate the schemas for all mapping files in our class 
tree--> 

<target name="schema"depends="prepare"® 

description="Generate DB schema from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration> 

<fileset dir="${class.root}"> 

<include name="**/*.hbm.xm1l"/ > 

</fileset > 

</configuration> 

<hbm2ddl1 drop="yes"/>® 

</hibernatetool > 

</target> 


@ 首 乞 ， 我 们 加 了 一 个 prepare 构 建 目标 ， 以 供 其 他 构建 目标 使 
用 ， 而 不 是 从 命令 行 直接 调用 。 其 用 途 是 在 必要 时 创建 classes 目 孙 ， 以 
便 将 编译 好 的 Java 代 码 放 在 这 个 日 录 中 ， 青 把 src 目 隶 中 找到 的 任 
何 .properties 文 件 和 了 映射 文件 都 复制 到 对 应 目录 的 classes 屋 。 这 种 层次 
式 的 复制 是 Ant 相 当 棱 的 功能 (使 用 特殊 的 “**/*” 匹 配 模 式 ) ， 让 我 们 
可 以 定义 和 编辑 源 代码 文件 会 使 用 到 的 相关 资源 ， 同 时 在 运行 时 通过 
类 加 载 器 (class loader) 来 使 用 这 些 资源 。 


@ 这 一 设置 会 让 Ant 复 制 所 有 找到 的 XML 文件 ， 而 不 仅仅 是 映射 文 
档 。 虽 然 我 们 现在 还 不 需要 这 样 的 配置 文件 ， 但 以 后 当 我 们 切换 到 基 
于 XML 的 Hibernate 配 置 文件 时 ， 这 一 设置 加 显得 很 重要 了 。 


人 @schema 构 建 目 标 需 要 依赖 prepare 构 建 目标 ， 让 它 把 映射 文档 复 
制 到 正确 的 位 置 以 供 运 行 时 使 用 。 它 会 用 hbm2ddl 模 式 来 调用 Hibernate 
工具 ， 让 它们 为 在 classes 目 孙 中 找 到 的 任何 映射 文档 生成 相应 的 数据 库 
模式 《如 前 所 述 ， 在 下 一 章 我 们 使 用 功能 更 强大 的 Hibernate XML 配置 
文件 时 ， 这 样 就 会 更 简单 些 ) 。 


@ 可 以 为 schema 生 成 工具 指定 很 多 参数 ， 以 配置 其 工作 方式 。 在 
这 个 例子 中 ， 我 们 告诉 schema 生 成 工具 在 根据 映射 文档 生成 新 的 数据 
表 定义 之 前 ， 先 删除 原来 可 能 已 经 存在 的 (drop=yes) 。 有 关 这 一 配置 
和 其 他 配置 远 项 的 更 多 细 订 ， 可 以 查阅 Hibernate Tools 参 考 于 册 。 


Hibernate 其 至 可 以 检查 现 有 的 数据 表 ， 并 笑 试 计算 出 如 何 修改 
schema， 才 能 反映 出 新 映射 文件 的 变化 。 


在 添加 了 这 些 内 容 以 后 ， 就 可 以 准备 为 我 们 的 TRACK 表 生成 数据 
库 schema 了 “。Hibernate 可 以 为 实现 我 们 的 目标 而 完成 许多 奇特 的 操 
作 ， 并 井然 有 序 地 完成 处 理 。 我 们 只 需要 为 一 定 的 消息 配置 好 日 志 处 
理 ， 就 可 以 很 容易 地 观察 到 Hibernate 进 行 的 操作 过 程 。 为 此 ， 我 们 需 
要 配置 Log4j， 这 是 Hibernate 所 使 用 的 日 志 处 理 环境 。 最 简单 的 配置 方 
法 是 直接 在 类 路 径 下 放 一 个 log4j.properties 文 件 。 我 们 可 以 利用 现 有 的 
prepare target， 在 Ant 复 制 Hibernate 的 .properties 文 件 时 ， 顺 便 将 
log4j.properties 文 件 从 src 目 录 复 制 到 classes 目 录 。 


在 src 目 录 下 创建 一 个 名 为 log4j.properties 的 文件 ， 内 容 如 例 2-6 所 
示 。 (一 种 简单 的 做 法 就 是 从 你 下 载 的 Hibernate 发 行 包 中 的 
doc/tutorial/src 目 录 将 这 个 文件 复制 出 来 ， 因 为 该 文件 就 是 给 Hibernate 
发 行 包 所 带 的 示例 使 用 的 。 如 果 你 自己 输入 ， 则 可 以 跳 过 注释 块 的 内 
容 ， 它 们 只 是 介绍 一 些 有 用 的 日 志 功 能 的 其 他 选项 。) 


例 2-6: log4j.properties 日 志 配 置 文 件 


###direct log messages to stdout### 

10g4j.appender.stdout=org.apache.10g4j.ConsoleAppender 

log4j .appender.stdout.Target=System.out 

log4j .appender.stdout.layout=org.apache.1log4j.PatternLayout 

log4j .appender.stdout. layout .ConversionPattern=%d {ABSOLUTE }%5p%c { 
1}: %L-%m%N 

###direct messages to file hibernate. log### 


#10g4j.appender .file=org.apache.1log4j.FileAppender 

#log4j .appender.file.File=hibernate.log 

#log4j .appender.file.layout=org.apache.1log4j.PatternLayout 

#log4j .appender.file. layout .ConversionPattern=%d{ABSOLUTE}%5p%c {1 
}: %L-%m%N 

###set log levels-for more verbose logging 
change'info'to'debug'### 

log4j.rootLogger=warn, stdout 

log4j.logger.org.hibernate=info 

#1094j.logger.org.hibernate=debug 

###log HQL query parser activity 

#1094j.logger.org.hibernate.hql.ast.AST=debug 

###log just the SQL 

#1094j.logger.org.hibernate.SQL=debug 

###10g JDBC bind parameters### 

log4j .logger.org.hibernate.type=info 

#10g94j.logger.org.hibernate. type=debug 

###10g schema export/update### 

log4j .logger.org.hibernate.tool.hbm2dd1=debug 

###10g HQL parse trees 

#10g94j.logger.org.hibernate.hql=debug 

###10g cache activity### 

#10g94j.logger.org.hibernate.cache=debug 

###1log transaction activity 

#1094j.logger.org.hibernate.transaction=debug 

###1log JDBC resource acquisition 

#1094j.logger.org.hibernate. jdbc=debug 

###enable the following line if you want to track down 
connection### 

###leakages when using DriverManagerConnectionProvider### 

#1094j.logger.org.hibernate.connection.DriverManagerConnectionPro 
vider=trace 


有 了 日 志 配 置 文件 以 后 ， 你 可 能 会 想 编辑 build.xzml 中 的 codegen 目 
标 ， 使 其 也 依赖 于 新 的 prepare 目 标 。 这 样 可 以 确保 无 论 何 时 调用 
codegen， 都 配置 了 日 志 处 理 ， 而 有 晶 Hibernate 配 置 也 可 以 使 用 ， 消 除了 
我 们 第 一 次 使 用 它 时 的 矿 烦 。 


现在 可 以 制作 数据 库 模 式 了 ! 在 项 目 目 录 的 命令 行 下 ， 执 行 命令 
ant prepare， 接 着 再 执行 ant schema。 你 会 看 到 类 似 例 2-7 内 容 的 输出 ， 


同时 还 会 创建 classes 目 孙 ， 并 在 其 中 生成 了 各 种 资源 文件 ， 再 接着 就 会 


运行 模式 生成 器 (schema generator) 。 


例 2-7: 使 用 HSQLDB 的 租 入 式 数 据 库 服务 器 来 建立 数据 库 模 式 


%ant prepare 

Buildfile: build.xml 

prepare: 

[mkdir ]Created 
dir: /Users/jim/svn/oreilly/hib_dev_2e/current/examples/ 

ch02/classes 

[copy]Copying 3 files 
to/Users/jim/svn/oreilly/hib_dev_2e/current/ 

examples/ch02/classes 

BUILD SUCCESSFUL 

Total time: 0 seconds 

%ant schema 

Buildfile: build.xml 

prepare: 

schema: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]1.task: hbm2ddl (Generates database schema) 

[hibernatetool]22: 38: 21, 858 INFO Environment: 514-Hibernate 
3.2.5 

[hibernatetool]22: 38: 21, 879 INFO Environment: 532-loaded 
properties from reso 

urce hibernate.properties: {hibernate.connection.username=sa, 
hibernate.connecti 

on.password=****, 
hibernate.dialect=org.hibernate.dialect.HSQLDialect, hibernate. 

connection.shutdown=true, hibernate.connection.url=jdbc: hsqldb: 
data/music, hibe 

rnate.bytecode.use_reflection_optimizer=false, 
hibernate.connection.driver_class 

=org.hsqldb. jdbcDriver} 

[hibernatetool]22: 38: 21, 897 INFO Environment: 681-Bytecode 
provider name: cg 

lib 

[hibernatetool]22: 38: 21, 930 INFO Environment: 598-using JDK 1.4 
java.sql.Time 

stamp handling 


[hibernatetool]22: 38: 22, 108 INFO Configuration: 299-Reading 
mappings from fil 

e: /Users/jim/Documents/work/OReilly/svn_hibernate/current/exampl 
es/ch02/classes/ 

com/oreilly/hh/data/Track.hbm. xml 

[hibernatetool]22: 38: 22, 669 INFO HbmBinder: 300-Mapping class: 
com.oreilly.hh. 

data. Track- >TRACK 

[hibernatetool]22: 38: 22, 827 INFO Dialect: 152-Using dialect: 
org.hibernate.di 

alect.HSQLDialect 

[hibernatetool]22: 38: 23, 186 INFO SchemaExport: 154-Running 
hbm2dd1 schema exp 

ort 

[hibernatetool]22: 38: 23, 194 DEBUG SchemaExport: 170-import file 
not found: /im 

port.sql 

[hibernatetool]22: 38: 23, 197 INFO SchemaExport: 179-exporting 
generated schema 

to database 

[hibernatetool]22: 38: 23, 232 INFO 
DriverManagerConnectionProvider: 41-Using Hi 

bernate built-in connection pool (not for production use! ) 

[hibernatetool]22: 38: 23, 234 INFO 
DriverManagerConnectionProvider: 42-Hibernat 

e connection pool size: 20 

[hibernatetool]22: 38: 23, 241 INFO 
DriverManagerConnectionProvider: 45-autocomm 

it mode: false 

[hibernatetool]22: 38: 23, 255 INFO 
DriverManagerConnectionProvider: 80-using dr 

iver: org.hsqldb.jdbcDriver at URL: jdbc: hsqldb: data/music 

[hibernatetool]22: 38: 23, 258 INFO 
DriverManagerConnectionProvider: 86-connecti 

on properties: {user=sa, password=****, shutdown=true} 

[hibernatetool]drop table TRACK if exists; 

[hibernatetool]22: 38: 23, 945 DEBUG SchemaExport: 303-drop table 
TRACK if exists; 

[hibernatetool]create table TRACK (TRACK_ID integer generated by 
default as ide 

ntity (start with 1) , title varchar (255) not null, filePath 
varchar (255) not nul 

1, playTime time, added date, volume smallint not null, primary 
key (TRACK_ID) ) ; 

[hibernatetool]22: 38: 23, 951 DEBUG SchemaExport: 303-create 
table TRACK (TRACK_ 

ID integer generated by default as identity (start with 1) , title 
varchar (255) n 


ot null, filePath varchar (255) not null, playTime time, added 
date, volume small 

int not null, primary key (TRACK_ID) ) ; 

[hibernatetool]22: 38: 23, 981 INFO SchemaExport: 196-schema 
export complete 

[hibernatetool]22: 38: 23, 988 INFO 
DriverManagerConnectionProvider: 147-cleanin 

g up connection pool: jdbc: hsqldb: data/music 

BUILD SUCCESSFUL 

Total time: 2 seconds 


在 模式 导出 (schema export) 部 分 的 末尾 ， 你 能 够 看 到 Hibernate 用 
于 创建 TRACK 表 的 真实 SQL 语 句 。 如 果 你 查看 data 目 录 下 music.script 文 
件 的 开头 部 分 ， 就 会 发 现 它 已 经 整合 到 数据 库 了 。 为 了 采用 更 友好 的 
(也 许 是 更 方便 的 ) 方式 来 查看 数据 ， 可 以 执行 ant db 来 启动 HSQLDB 
图 形 界面 ， 如 图 2-1 所 示 。 


E ja 上 chsaldb data/music 
日 TRACK 
schema: PUBLIC 
B TRACK_ID 
Type: INTEGER 
Nullable: false 
B TITLE 
Type: VARCHAR 
Nullable: false 
E FILEPATH 
Type: VARCHAR 
Nullable: false 
B PLAYTIME 
Type: TIME 
Nullable: true 
B ADDED 
Type: DATE 
Nullable: true 
B VOLUME 
Type: SMALLINT 
Nullable: false 
Indices 
__B Properties 


图 2-1 显示 新 的 TRACK 表 的 内 容 以 及 一 个 查询 的 数据 库 管理 器 界面 


细心 的 读者 可 能 会 问 ， 有 既然 schema target E ki F prepare T, HB 
为 什么 要 调用 两 次 Ant， 第 一 次 是 运行 prepare， 人 第 二 次 是 运行 schema 。 
文 是 一 种 所 谓 的 步步为营 法 (bootstrapping) 的 问题 ， 只 在 第 一 次 创建 
环境 时 才 会 遇 到 。 具 体 问 题 是 ，Ant 在 启动 时 会 处 理 属性 定义 ， 以 决定 
项 目 类 路 径 的 内 容 。 直 到 prepare 至 少 运行 一 次 以 前 ，classes 目 孙 还 不 存 
在 ， 也 不 会 包含 hibernate.properties 文 件 ， 所 以 在 类 路 径 中 也 不 包 
个 目录 。 在 prepare 运 行 以 后 ， 才 会 在 classes 目 录 生 成 这 个 文件 ， 而 


classes 目 如 也 才 会 包含 在 类 路 径 中 。 但 是 Ant 在 下 一 次 运行 以 前 ， 不 会 
重新 设置 属性 定义 。 所 以 ， 如 果 你 试图 在 第 一 次 Ant 运 行 时 就 运行 
schema 目 标 ，Hibernate 束 会 出 现 异 弟 ， 向 你 报告 没有 指定 一 个 数据 库 
方言 ， 因 为 它 找 不 到 配置 属性 文件 。 这 种 问题 经 常会 导致 令 人 困惑 的 
化 坎 。 不 过 ， 从 现在 起 ， 可 以 安全 地 直接 运行 schema 目 标 了 ， 并 通过 
它 来 调用 prepare， 按 照 需 要 复制 新 版 本 的 属性 文件 ， 因 为 它们 在 Ant 开 
9 运 行 时 ， 就 已 经 在 类 路 人 径 中 存在 了 。 


发 生 了 什么 事 


刚才 我 们 已 经 能 够 使 用 Hibernate 创 建 一 个 数据 表 了 ， 以 后 我 们 可 
以 将 Hibernate 为 我 们 创建 的 Java 类 实例 持久 地 保存 在 这 个 数据 表 中 。 我 
们 没有 输入 任何 一 行 SQL 或 Java 语 句 ! 当然 ， 我 们 的 数据 库 表 目前 还 是 
空 的 。 来 改变 它 吧 ! 下 一 章 会 介绍 你 可 能 最 想 学 习 的 主题 ， 在 Java 程 序 
中 使 用 Hibernate 将 Java 对 象 转 换 为 数据 库 中 的 数据 项 ， 并 进行 相反 的 转 
换 。 


在 深入 探讨 那 种 非常 酷 的 任务 之 前 ， 我 们 应 该 再 回想 一 下 通过 一 
些 XML 和 .properties 文 件 所 能 做 到 的 诸多 事项 ， 这 有 十 非常 有 价值 的 。 布 
望 你 已 经 开始 看 到 Hibernate 的 强大 功能 和 使 用 上 的 便利 了 。 


其 他 


其 他 ID 生成 方法 呢 ? 主键 (Key) 在 整个 数据 库 中 或 全 世界 都 是 惟 
一 的 吗 ?Hibernate 文 持 很 多 为 存储 在 数据 库 中 的 对 象 选 择 相 应 的 主键 
的 方法 。 这 是 由 generator 标 签 控制 的 ， 如 例 2-1 的 第 5 行 所 示 。 在 这 个 示 
例 中 ， 我 们 告诉 Hibernate， 对 其 遇 到 的 数据 库 类 型 使 用 最 自然 的 主键 
生成 方法 (native) 。 其 他 方法 还 包括 流行 的 "hilo" 算 法 、 全 局 UUID、 
完全 由 Java 程 序 代码 决定 的 方法 以 及 其 他 多 种 方法 。 具 体 细 节 ， 可 以 参 
阅 Hibernate 参 考 手册 文档 中 "Basic O/R Mapping" 那 一 章 的 "generator" 一 
节 。 此 外 ， 如 果 内 建 的 各 种 方法 都 满足 不 了 你 的 需要 (时 常 如 此 ) ， 
还 可 以 提供 你 自己 的 类 来 做 你 想 做 的 事情 (实现 
org.hibernate.id.Identifier-Generator 接 口 ， 再 把 实现 类 的 名 称 放 在 


generator 杯 签 内 ) 。 


如 果 你 想 学 习 一 下 用 Hibernate 连 接 你 所 更 熟悉 的 数据 库 的 示例 ， 
可 以 先 看 看 第 10 章 ， 这 一 章 将 演示 如 何 用 Hibernate 处 理 MySQL 数 据 
库 o 
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好 了 ， 通 过 前 两 章 的 学 习 ， 我 们 已 经 打 牢 了 基础 ， 定 义 好 对 象 / 关 
系 映射 (object/relational mapping) 后 ， 又 用 它 创建 了 相 匹 配 的 Java 类 
和 数据 库 表 。 但 这 如 何 应 用 呢 ? 现在 就 介绍 一 下 用 Hibernate 在 Java 程 
序 代码 中 处 理 持久 化 (persistent) 数据 是 多 么 的 方便 。 


配置 Hibernate 


在 我 们 继续 学 习 Hibernate 的 使 用 之 前 ， 我 们 需要 解决 某 些 妨碍 继 
续 前 进 的 问题 。 在 上 一 革 中 ， 我 们 使 用 src 目 录 下 的 hibernate.properties 
文件 来 配置 Hibernate 的 JDBC 连 接 。 在 这 一 章 中 ， 我 们 将 使 用 Hibernate 
XML 配置 文件 来 配置 JDBC 连 接 、SQL 方 言 等 各 种 Hibernate 设 置 。 与 
hibernate.properties 文 件 一 样 ， 我 们 也 把 这 个 XML 配置 文件 放 在 src 目 录 
中 。 将 例 3-1 的 内 容 输入 到 一 个 名 为 hibernate.cfg.xml 的 文件 中 ， 并 将 其 
保存 在 src 目 录 下 ， 再 删除 原来 的 hibernate.properties 文 件 。 


例 3-1: 用 XML 配置 Hibernate: hibernate.cfg.xml 


<?xml version="1.0"encoding="utf-8"?> 

<! DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-configuration- 
3.0.dtd"> 

<hibernate-configuration> 


<session-factory> 

<! --SQL dialect--> 

<property name="dialect">org.hibernate. dialect .HSQLDialect 
</property> @ 

<! --Database connection settings-->@ 

<property name="connection.driver_class">org.hsqldb.jdbcDriver 
</property> 

<property name="connection.url">jdbc: hsqldb: data/music 
</property> 

<property name="connection.username" >sa</property> 

<property name="connection. password" > </property> 

<property name="connection.shutdown">true</property> 


<! --JDBC connection pool (use the built-in one) --> 

<property name="Cconnection.pool_size">1</property>® 

<! --Enable Hibernate's automatic session context management -- > 

<property name="current_session_context_class">thread 
</property> 

<! --Disable the second-level cache-->® 

<property 


name="cache.provider_class">org.hibernate.cache.NoCacheProvider 
</property> 

<! --disable batching so HSQLDB will propagate errors 
correctly. --> 

<property name="jdbc.batch_size">0</property>® 

<! --Echo all executed SQL to stdout--> 

<property name="Show_sql">true</property>® 

<! --List all the mapping documents we're using-->@ 

<mapping resource="com/oreilly/hh/data/Track.hbm.xm1l"/> 

</session-factory> 

</hibernate-configuration> 


从 示例 中 可 以 看 到 ，hibernate.cfg.xml 配 置 了 SQL 方言 、JDBC 参 
数 、 连 接 池 (connection pool) 以 及 缓存 提供 者 (cache provider) 。 这 
个 XML 文档 还 引用 了 我 们 在 上 一 章 写 的 映射 文档 ， 这 样 就 不 需要 我 们 
再 从 Java 源 代码 中 引用 这 些 映 射 文档 了 。 稍 后 将 详细 介绍 这 一 配置 文 
件 的 细节 : 


@ 就 像 第 2 革 有 的 hibernate.properties 文 件 一 样 ， 我 们 在 这 一 行 是 为 使 

用 HSQLDB 而 定义 它 的 SQL 方 言 。 你 可 能 已 经 注意 到 property 元 素 的 
name 属 性 是 dialect， 类 似 于 .properties 文 件 中 的 属性 的 名 称 (也 就 是 
hibernate.dialect) 。 当 使 用 XML 配置 文件 来 配置 Hibernate 时 ， 其 实 也 
是 在 向 Hibernate 传 递 了 同样 的 属性 。 在 XML 配置 文件 中 ， 可 以 省 略 属 
性 名 称 的 hibernate. 前 级 。 这 一 区 段 (dialect) 和 下 一 区 段 

(connection) 的 配置 方法 与 我 们 在 第 2 章 hibernate.properties 文 件 中 的 
配置 是 一 样 的 。 


@ 用 于 配置 Hibernate 内 部 的 JDBC 连 接 的 属性 
(connection.driver_class ` connection.url ` connection.username ` 
connection.password 以 及 connection.shutdown) 与 例 2-4 的 
hibernate.properties 中 的 属性 集 也 一 一 对 应 。 


目 将 connection.pool_size 属 性 设置 为 1。 这 意味 着 Hibernate 将 创建 
一 个 只 保持 一 个 连接 的 JDBC Connection (连接 ) 池 。 数 据 库 连 接 池 对 
于 需要 达到 一 定 规模 的 大 型 应 用 程序 来 说 很 重要 ， 不 过 就 本 书 的 目的 
来 说 ， 我 们 可 以 放心 地 将 Hibernate 配 置 为 使 用 只 有 一 个 JDBC 连 接 的 内 
建 连接 池 。 在 连接 池 实 现 上 ，Hibernate 支 持 很 大 的 灵活 性 ， 可 以 非常 
容易 地 配置 Hibernate 来 使 用 其 他 的 连接 池 实 现 ， 例 如 Apache Commons 
DBCP 和 C3P0 ° 


@ 照 目前 情况 ， 当 Hibernate 执 行 实际 的 持久 化 操作 时 ， 它 束 会 壬 
告 我 们 还 没有 配置 它 的 二 级 缓存 系统 。 对 于 像 这 样 的 简单 应 用 程序 来 
说 ， 我 们 根本 不 需要 二 级 缓存 ， 所 以 这 一 行 配置 就 是 要 关闭 二 级 绥 
存 ， 将 每 个 操作 立即 发 送 到 数据 库 。 


@ 这 里 ， 我 们 是 在 关闭 Hibernate 的 JDBC 批 处 理 功能 。 虽 然 这 样 做 
会 稍微 降低 一 点 效率 (对 于 像 HSQLDB 这 样 的 内 存 数据 库 的 有 影响 微 平 
其 微 ) ， 不 过 为 了 获取 当前 HSQLDB 触 发 的 错误 报告 ， 有 必要 这 样 
做 。 当 打开 批 处 理 模式 时 ， 如 果 批 处 理 中 有 任何 语句 出 了 问题 ， 从 
HSQLDB 中 得 到 的 惟一 异常 将 只 是 BatchUpdateException， 告 诉 你 批 处 
理 失 败 。 这 样 错 误 报 告 对 调试 程序 几乎 没有 什么 用 。HSQLDB 的 作者 
说 这 个 问题 将 在 下 一 个 主要 发 行 版 本 中 得 以 修复 ; 在 此 之 前 ， 当 使 用 
HSQLDB 时 ， 为 了 明白 问题 的 来 龙 去 脉 :我 们 就 先 不 使 用 批 处 理 模 
式 。 


@how_sql 属 性 是 一 个 在 开发 和 调试 Hibernate 程 序 时 使 用 的 属性 。 
将 show_sql 设 置 为 tue， 就 告诉 Hibernate 要 它 打印 输出 对 数据 库 操作 时 
执行 的 每 条 语句 。 如 果 你 不 布 望 在 控制 台 看 到 打印 输出 的 SQL 语 句 ， 
可 以 将 这 个 属性 设置 为 false 。 


@ 最 后 一 部 分 列 出 了 在 我 们 的 项 目 中 使 用 的 所 有 了 映射 文档 。 注 
意 ， 路 径 中 包含 的 斜 杠 字符 〈《“/”) 是 相对 于 src 目 录 的 。 这 一 路 径 指 明 
了 .hbm.xml 文 件 作 为 资源 在 类 路 径 上 的 位 置 。 通 过 在 这 里 列 出 这 些 文 


件 ， 我 们 就 不 用 在 处 理 映 射 类 的 build.xml 构 建 目标 中 显 式 说 明 如 何 找 
到 它们 ( 稍 后 可 以 看 到 ) ， 也 不 需要 像 本 书 的 旧版 那样 在 每 个 例子 源 
代码 的 main O 方法 中 加 载 这 些 映射 文档 。 把 所 有 映射 文档 集中 在 一 
起 古 个 不 错 的 做 法 。 


除了 src 目 录 下 的 hibernate.cfg.xml 文 件 ， 还 需要 修改 build.xml 以 引 
用 这 个 新 的 XML 配置 文件 。 修 改 codegen 和 schema 构 建 目标 内 的 
configuration 元 素 ， 如 例 3-2 中 用 粗 体 显示 的 几 行 所 示 。 例 3-2: 修改 
build.xml， 以 使 用 新 的 Hibernate XML 配置 文件 


<! --Generate the java code for all mapping files in our source 
tree--=> 

<target name="codegen"depends="prepare" 

description="Generate Java source from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
configurationfile="${source.root}/hibernate.cfg.xml"/> 

<hbm2java/> 

</hibernatetool> 

</target> 

<! --Generate the schemas for all mapping files in our class 
tree--=> 

<target name="schema"depends="prepare" 

description="Generate DB schema from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
configurationfile="${source.root}/hibernate.cfg.xml"/> 

<hbm2dd1 drop="yes"/> 

</hibernatetool> 

</target> 


这 两 行 告诉 Hibernate Tools Ant 构 建 任 务 ， 到 哪里 查找 Hibernate 
XML 配 置 文件 ， 这 样 ，Ant 任 务 就 可 以 在 这 个 配置 文件 中 找到 它们 需 
要 的 所 有 信息 (包括 正在 处 理 的 映射 文档 回想 一 下 第 2 章 的 做 法 ， 我 
们 不 得 不 在 configuration 元 素 中 显 式 构建 了 Ant 的 fileset 元 素 ， 以 匹配 项 
目 源 代码 树 中 的 所 有 了 映射 文件 ) 。 从 现在 起 ， 本 书 的 剩余 部 分 将 全 音 
使 用 Hibernate XML 配置 文件 ， 这 样 可 以 更 方便 地 为 Hibernate 的 相关 工 
具 传递 各 种 需要 的 信息 。 


现在 我 们 已 经 成 功 地 配置 好 了 Hibernate， 下 面 我 们 豆 回 到 本 章 的 
主要 任务 : 生成 持久 化 对 象 。 


创建 持久 化 对 象 


我 们 先 创 建 几 个 新 的 Track 实例 ， 再 把 它们 持久 化 保存 到 数据 库 ， 
这 样 束 能 看 看 对 象 到 的 是 怎样 转换 成 数据 库 表 的 行 和 列 的 。 因 为 我 们 
完全 按照 标准 的 Hibernate 要 求 来 组 织 映 射 文档 和 配置 文件 ， 所 以 配置 
Hibernate 的 会 话 工厂 (session factory) 也 就 变 得 相当 容易 了 。 


应 该 怎么 做 


这 里 的 讨论 假设 你 已 经 按照 第 2 章 的 示例 ， 创 建 好 了 数据 库 模 式 ， 
并 生成 了 Java 人 代码。 如果 你 还 没有 做 这 些 ， 可 以 从 本 书 的 网 站 (1) 
下 载 示 例文 件 ， 直 接 跳 转 到 ch03 目 隶 ， 使 用 命令 ant prepare 和 ant 
codegen (P!) ， 再 接着 执行 ant schema， 就 可 以 自动 取 回 这 个 示例 所 
需要 的 Hibernate 和 HSQLDB 库 ， 并 生成 Java 代 码 和 数据 库 模 式 。 (和 其 
他 示例 一 样 ， 这 些 命 令 都 应 该 在 shell 窗 口中 执行 ， 而 当前 工作 目录 就 
是 你 的 项 目 日 录 树 的 顶级 目录 ， 也 就 是 包 全 Ant build.xml 文 件 的 地 
JA) 


我 们 先 从 一 个 简单 的 示范 用 的 CreateTest 类 开始 ， 它 包含 了 必要 的 
导入 (import) 语句 ， 以 及 一 些 辅助 代码 ， 用 于 设 定 Hibernate 环 境 ， 再 


创建 几 个 用 XML 映射 文件 来 进行 持久 化 存储 的 Track 实例 。 源 代码 如 例 
3-3 所 示 ， 它 位 于 src/com/oreilly/hh 目 录 中 。 


例 3-3: 数据 创建 测试 ，CreateTest.java 


package com.oreilly.hh; 
import org.hibernate.*; @ 
import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data.*; 
import java.sql.Time; 
import java.util.Date; 
pA 

*Create sample data, letting Hibernate persist it for us. 
*/ 
public class CreateTest{ 
public static void main (String args[]) throws Exception{ 
//Create a configuration based on the XML file we've put 
//in the standard place. 
Configuration config=new Configuration () ; @ 
config.configure () ; 
//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; © 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; @ 
Transaction tx=null; 
try{ 
//Create some data and persist it 
tx=session.beginTransaction () ; © 
Track track=new Track ("Russian Trance", 
"yvol2/album610/track02.mp3", 
Time.valueOf ("00: 03: 30") , new Date () , 

(short) 0) ; 
session.save (track) ; 
track=new Track ("Video Killed the Radio Star", 
"yol2/album611/track12.mp3", 
Time.valueOf ("00: 03: 49") , new Date () , 

(short) 0) ; 

session.save (track) ; 

track=new Track ("Gravity's Angel", 
"yvyol2/albumi175/track03.mp3", 
Time.valueOf ("00: 06: 06") , new Date () , 

(short) 0) ; 

session.save (track) ; 


//We're done; make our changes permanent 
tx.commit () ; © 

}catch (Exception e) { 

if (tx! =null) { 

//Something went wrong; discard all partial changes 
tx.rollback () ; 

throw new Exception ("Transaction failed", e) ; 
}finally{ 

//No matter what, close the session 
session.close () ; 

//Clean up after ourselves 
sessionFactory.close () ; @ 


} 
} 


需要 对 CreateTest.java 的 第 一 部 分 做 些 解释 : 


@ 我 们 导入 一 些 有 用 的 Hibernate 类 (包括 Configuration) ， 用 它们 
来 建立 Hibernate 运 行 环境 。 此 外 还 需要 导入 Hibernate 根 据 映 射 文档 生成 
的 所 有 数据 类 ， 这 些 都 在 data 包 中 。 数 据 对 象 中 用 Time 和 Date 类 来 代表 
曲目 的 播放 时 间 和 创建 时 间 戳 (timestamp) 。 在 CreateTest 中 实现 的 惟 
一 方法 是 main () 方法 ， 以 文 持 从 命令 行 的 调用 。 


@@ 当 运行 这 个 类 时 ， 它 首先 创建 一 个 Hibernate Configuration 对 象 。 
由 于 我 们 没有 告诉 Hibernate 什 么 其 他 信息 ， 所 以 它 默 认 在 类 路 径 的 根 
上 查找 名 为 hibernate.cfg.xml 的 文件 。Hibernate 会 找到 我 们 前 面 创 建 的 
这 个 配置 文件 ， 通 过 这 个 配置 文件 来 告诉 Hibernate 我 们 正在 使 用 
HSQLDB， 以 及 如 何 找到 数据 库 。 这 个 例子 的 XML 配置 文件 就 包含 了 


对 Track 对 象 的 Hibernate Mapping XML 文档 的 引用 。 调 用 
config.configure () 就 会 自动 加 载 Track 类 的 映射 文档 。 


日 为 了 创建 和 持久 化 曲目 数据 ， 这 就 是 我 们 需要 的 所 有 配置 ， 这 
样 束 为 创建 SessionFactory 做 好 了 准备 。 该 对 象 的 用 途 是 为 我 们 提供 会 
话 对 象 ， 它 是 同 Hibernate 进 行 交 互 的 主要 途径 。SessionFactory 是 线程 
安全 的 ， 在 整个 应 用 程序 中 只 需要 创建 它 的 一 个 实例 《更 准确 地 说 ， 
对 于 每 一 个 需要 提供 持久 化 服务 的 数据 库 环 境 ， 只 需要 一 个 
SessionFactory 实 例 ; 因此 大 多 数 应 用 程序 只 需要 一 个 这 样 的 实例 ) 。 
创建 会 话 工 厂 是 一 个 需要 花费 相当 代价 和 耗 时 的 操作 ， 所 以 应 该 在 整 
个 应 用 程序 中 共享 这 个 实例 。 在 只 包含 一 个 类 的 应 用 程序 中 进行 这 样 
的 操作 显得 有 些 繁琐 ， 不过， 参考 文档 提供 了 一 些 在 更 实现 的 场景 中 
应 该 如 何 应 用 的 好 例子 。 


注意 : 牢固 地 理解 这 些 对 象 的 目的 和 生命 周期 ， 值 ! 本 书 介 绍 的 
知识 足以 让 你 起 步 了 ; 你 应 该 继续 花 些 时 间 阅 读 参 考 文档 ， 深 入 理解 
各 个 例子 。 


@ 这 一 步 才 到 了 真正 执行 持久 化 的 上 时候， 让 SessionFactory 打 开 一 
个 会 话 ， 这 会 建立 一 个 到 数据 库 的 连接 ， 并 提供 一 个 上 下 文 
(context) 环境 ， 在 这 个 上 下 文中 我 们 可 以 创建 、 获 取 、 处 理 以 及 删 
除 持久 化 对 象 。 只 要 保持 会 话 为 打开 状态 ， 束 会 维护 一 个 到 数据 库 的 
连接 ， 与 会 话 相 关联 的 持久 对 象 的 变化 都 可 以 被 跟踪 ， 这 样 ， 当 关闭 


会 话 时 ， 这 些 变化 就 可 以 应 用 到 数据 库 。 从 概念 上 六 ， 你 可 以 把 会 话 
认为 是 持久 化 对 和 象 和 数据 库 之 间 的 一 个 “大 型 事务 ”， 它 可 以 包含 多 个 
数据 库 级 的 事务 。 不 过 ， 和 数据 库 事务 一 样 ， 在 应 用 程序 运行 期 间 长 
时 间 地 打开 Hibernate session (例如 在 等 候 用 户 输入 时 ) 。 在 应 用 程序 
中 一 个 会 话 只 用 于 一 个 特定 的 、 边 办 有 限 的 操作 ， 例 如 生成 用 户 界 面 
或 者 根据 用 户 提交 的 信息 做 出 相应 的 变化 。 而 随后 的 操作 则 使 用 一 个 
新 的 会 话 。 还 要 注意 的 是 ， 会 话 对 象 本 身 不 是 线程 安全 的 ， 所 以 不 能 
在 线程 之 间 共 享 它们 。 每 个 线程 需要 从 会 话 工厂 类 中 获取 它们 目 己 的 


会 话 。 


有 必要 深入 介绍 一 下 Hibernate 中 映射 对 象 的 生命 周期 ， 以 及 它 与 
会 话 的 关系 ， 因 为 这 一 术语 相当 特殊 ， 相 关 的 概念 也 很 重要 。 一 个 映 
POTS 例如 我 们 的 Track 类 的 一 个 实例 ) 会 在 与 Hibernate 相 关 的 两 个 
状态 之 间 回 来 转换 ， 瞬时 状态 (transient) 和 持久 化 状态 
(persistent) 。 处 于 瞬时 状态 的 对 象 不 与 任何 会 话 关联 。 当 用 new () 
第 一 次 创建 一 个 Track 实例 时 ， 它 就 是 瞬时 状态 的 ;除非 告诉 Hibernate 
持久 化 这 个 瞬时 状态 的 对 象 ， 否 则 当 应 用 程序 结束 时 ， 这 个 对 象 就 会 
永远 消失 。 


将 一 个 瞬时 状态 的 映射 对 象 传 递 给 会 话 的 save () 方法 ， 就 会 持久 
化 保存 这 个 对 象 ， 这 样 ， 在 Java VM 结束 以 后 ， 这 个 数据 对 象 还 能 够 存 
在 ， 直 到 以 后 显 式 地 删除 它 。 如 果 你 已 经 有 了 一 个 持久 化 对 象 ， 并 对 


它 调用 会 话 的 delete () 方法 ， 这 个 对 象 就 会 再 回 到 瞬时 状态 。 虽 然 这 
个 对 象 在 应 用 程序 中 仍然 作为 一 个 实例 而 存在 ， 但 它 不 会 持久 保存 起 
来 ， 除 非 你 改变 了 主意 ， 要 再 保存 它 一 次 。 另 一 方面 ， 如 果 你 还 没有 
删除 这 个 对 象 《所 以 它 仍 然 处 于 持久 化 状态 ) ， 当 修改 这 个 对 象 后 ， 

为 了 让 对 象 的 变化 得 以 反映 到 数据 库 中 ， 并 不 需要 再 显 式 地 保存 它 一 
次 。Hibernate 会 自动 跟踪 对 任何 持久 化 对 象 作 出 的 修改 ， 并 在 适当 的 
时 机 将 这 些 变 化 刷新 写 入 到 数据 库 中 。 当 关闭 会 话 时 ， 任 何 延迟 的 变 
化 都 会 被 保存 到 数据 库 中 。 


注意 : 坚持 一 下 ， 我 们 很 快 融 回 到 例子 的 介绍 ! 


当 在 已 经 关闭 的 会 话 中 使 用 持久 化 对 象 ， 例 如 ， 当 运行 完 一 个 查 
询 ， 找 到 所 有 匹配 某 条 件 的 实体 〈 本 章 稍 后 的 “检索 持久 化 对 象 ” 一 季 
将 介绍 如 何 做 到 这 一 点 ) 以 后 ， 处 理 这 些 实体 的 状态 就 涉及 一 个 重要 
但 又 微妙 的 要 点 。 如 前 所 述 ， 保 持 会 话 打 开 的 时 间 最 好 不 要 超过 执行 
数据 库 操作 的 必要 时 间 ， 所 以 在 查询 完成 以 后 ， 就 应 该 马上 关闭 会 
话 。 如 有 果 这 时 再 处理 已 经 加 载 的 映射 对 象 ， 会 怎么 样 ? WB, SAT 
开 时 ， 这 些 对 象 确实 是 持久 化 对 象 ， 但 是 它们 现在 不 再 与 任何 活动 的 
会 话 相 关联 了 (在 这 个 例子 中 ， 是 因为 关闭 了 会 话 ) ， 所 以 它们 就 不 
再 是 持久 化 对 象 了 。 不 过 ， 这 并 不 意味 着 它们 代表 的 数据 在 数据 库 中 
也 不 存在 了 ; 相反， 如 果 再 次 运行 查询 (假设 这 时 没有 人 修改 过 数 
据 ， 还 是 能 够 取 回 同样 的 一 组 对 象 。 这 只 是 意味 着 : 数据 对 象 的 状 


仿 在 虚拟 机 和 数据 库 之 间 当 前 没有 通信 ， 它 们 处 于 脱 管状 态 

(detached) 。 完 全 有 理由 可 以 继续 使 用 这 种 对 象 。 如 果 以 后 需要 修改 
这 些 对 象 ， 还 想 把 这 些 修改 持久 保存 ， 你 可 以 打开 一 个 新 的 会 话 ， 用 
它 来 保存 修改 过 的 对 象 。 因 为 每 个 实体 都 有 一 个 惟一 的 ID， 在 新 的 会 
话 中 ，Hibemate 没 有 问题 地 可 以 知道 如 何 把 处 于 瞬时 状态 的 对 象 链接 
到 正确 的 持久 化 对 象 。 


当然 ， 对 脱 管 对 象 信息 的 修改 都 要 由 具体 的 数据 库 环 境 作 为 文 
持 ， 所 以 你 需要 考虑 应 用 程序 级 的 数据 完整 性 约束 。 可 能 需要 设计 某 
种 高 级 的 锁定 或 版 本 化 协议 来 文 持 脱 管 对 象 的 管理 。 虽 然 Hibernate 为 
这 一 任务 也 提供 了 一 定 帮助 ， 但 是 设计 和 实现 细 闻 还 得 由 你 负责 。 参 
考 手 册 强 烈 推 荐 使 用 一 个 version 字 段 ， 而 且 也 有 多 种 办 法 可 供 选 用。 


@ 有 了 这 些 概念 和 术语 ， 这 个 例子 的 其 他 部 分 就 很 容易 理解 了 。 
我 们 用 打开 的 会 话 建立 了 一 个 数据 库 事务 ， 在 这 个 事务 内 部 ， 又 创建 
了 一 些 包含 示例 数据 的 Track 实例 ， 并 在 会 话 中 进行 傈 存 ， 这 样 束 把 它 
们 由 瞬时 状态 的 实例 转变 为 持久 化 的 实体 。 


@ 最 后 ， 我 们 提交 事务 ， 目 动 地 〈 作 为 一 个 单独 的 、 不 可 分 割 的 
单元 ) 将 所 有 数据 库 修 改 持久 化 。 环 绕 着 所 有 这 些 代码 周围 的 
try/catch/finally 块 演示 了 在 进行 事务 处 理 时 一 种 重要 而 且 有 用 的 习惯 用 
法 。 如 果 操 作 期 间 发 生 了 任何 错误 ，catch 块 就 会 回 深 (roll back) 事 
务 ， 再 抛 出 异常 。 在 finally 部 分 中 会 关闭 会 话 ， 以 确保 无 论 我 们 是 成 功 


提交 事务 后 沿 看 “愉快 的 小 路 ?正常 退出 ， 还 是 因为 导致 回 滚 的 异 稼 而 
退出 ， 最 终 都 可 以 关闭 会 话 。 


@ 在 方法 最 后 ， 我 们 也 关闭 了 会 话 工厂 本 身 。 这 是 应 用 程序 中 “ 优 
雅 地 关闭 ” (graceful shutdown) 部 分 应 该 进行 的 操作 。 在 Web 应 用 环境 
中 ， 这 应 该 是 一 定 的 生命 周期 事件 处 理 器 。 在 这 个 简单 的 例子 中 ， 当 
main () 方法 返回 时 ， 应 用 程序 就 正在 结束 。 


现在 一 切 就 绕 ， 通 知 Ant 如 何 编译 和 运行 这 个 测试 程序 就 更 简单 
了 。 将 例 3-4 所 示 的 构建 目标 添加 到 build.xml 末 尾 的 </project> 关闭 标 
签 之 前 。 


例 3-4: 用 于 编译 所 有 Java 源 代码 ， 并 调用 数据 创建 测试 的 Ant 构 建 
目标 


<! --Compile the java source of the project--> 

<target name="compile"depends="prepare"@ 

description="Compiles all Java classes"> 

<javac srcdir="${source.root}" 

destdir="${class.root}" 

debug="on" 

optimize="off" 

deprecation="on" > 

<classpath refid="project.class.path"/> 

</javac> 

</target> 

<target name="ctest"description="Creates and persists some 
sample data" 

depends="compile" >@ 

<java classname="com.oreilly.hh.CreateTest"fork="true" > 

<classpath refid="project.class.path"/> 

</java> 

</target> 


@ 命 名 得 体 的 编译 构建 目标 使 用 内 建 的 javac 构 建 任 务 ， 将 src 目 录 
中 的 所 有 Java 源 文件 编译 到 classes 目 了 未 中 。 科 好 ， 这 个 构建 任务 也 文 持 
我 们 已 经 建立 的 项 目 类 路 径 ， 所 以 编译 器 能 够 找到 我 们 正在 使 用 的 所 
有 依赖 库 。 构 建 目 标定 义 中 的 depends=prepare 属 性 是 告诉 Ant 在 运行 编 
译 构建 目标 以 前 ， 必 须 移 运行 prepare。Ant 负 责 管 理 依赖 关系 ， 当 构建 
具有 依赖 关系 的 多 个 目标 时 ， 能 够 以 正确 的 顺序 执行 ， 每 个 依赖 只 执 
行 一 次 ， 即 便 多 个 构建 目标 都 引用 了 同一 个 依赖 。 


如 果 你 习惯 使 用 shell 脚 本 来 编译 很 多 Java 源 代码 ， 那 么 可 能 会 对 这 
么 快 的 编译 速度 感到 吃惊 。Ant 调 用 的 是 它 上 自己 使 用 的 虚拟 机 内 部 的 
Java 编 译 严 ， 所 以 没有 针对 每 个 编译 的 处 理 局 动 延迟 。 


@ctest 构 建 目 标 使 用 编译 来 确保 已 经 构建 好 了 所 有 类 文件 ， 接 着 再 
创建 一 个 新 的 Java 虚 拟 机 来 运行 我 们 的 CreateTest 类 。 


好 了 ， 我 们 可 以 创建 一 些 数据 了 ! 例 3-5 显 示 了 调用 新 的 ctest 构 建 
目标 的 结 采 。ctest 要 依赖 于 compile 构 建 目 标 ， 这 样 惑 能 确保 在 使 用 之 
前 CreateTest 类 会 移 编 译 好 。ctest 本 吴 的 输出 结 采 会 显示 Hibernate 所 发 
出 的 日 志 信息 (建立 环境 和 映射 数据 以 及 数据 库 连 接 的 关闭 ) 。 


例 3-5: 调用 CreateTest 类 


%ant ctest 
prepare: 
compile: 


[javac]Compiling 2 source files 
to/Users/jim/svn/oreilly/hib_dev_2e/ 

current/examples/ch03/classes 

ctest: 

[java]00: 21: 45, 833 INFO Environment: 514-Hibernate 3.2.5 

[java]00: 21: 45, 852 INFO Environment: 547-hibernate. properties 
not found 

[java]00: 21: 45, 864 INFO Environment: 681-Bytecode provider 
name: cglib 

[java]00: 21: 45, 875 INFO Environment: 598-using JDK 1.4 
java.sql.Timestam 

p handling 

[java]00: 21: 46, 032 INFO Configuration: 1426-configuring from 
resource: / 

hibernate.cfg. xml 

[java]00: 21: 46, 034 INFO Configuration: 1403-Configuration 
resource: /hib 

ernate.cfg. xml 

[java]00: 21: 46, 302 INFO Configuration: 553-Reading mappings 
from resourc 

e: com/oreilly/hh/data/Track.hbm. xml 

[java]00: 21: 46, 605 INFO HbmBinder: 300-Mapping class: 
com.oreilly.hh.dat 

a.Track- > TRACK 

[java]00: 21: 46, 678 INFO Configuration: 1541-Configured 
SessionFactory: n 

ull 

[java]00: 21: 46, 860 INFO DriverManagerConnectionProvider: 41- 
Using Hibern 

ate built-in connection pool (not for production use! ) 

[java]00: 21: 46, 862 INFO DriverManagerConnectionProvider: 42- 
Hibernate co 

nnection pool size: 1 

[java]00: 21: 46, 864 INFO DriverManagerConnectionProvider: 45- 
autocommit m 

ode: false 

[java]00: 21: 46, 879 INFO DriverManagerConnectionProvider: 80- 
using driver 

: org.hsqldb.jdbcDriver at URL: jdbc: hsqldb: data/music 

[java]00: 21: 46, 891 INFO DriverManagerConnectionProvider: 86- 
connection p 

roperties: {user=sa, password=****, shutdown=true} 

[java]00: 21: 47, 533 INFO SettingsFactory: 89-RDBMS: HSQL 
Database Engine, 

version: 1.8.0 

[java]00: 21: 47, 538 INFO SettingsFactory: 90-JDBC driver: HSQL 
Database E 

ngine Driver, version: 1.8.0 


[java]00: 21: 47, 613 INFO Dialect: 152-Using dialect: 
org.hibernate.dialec 

t.HSQLDialect 

[java]00: 21: 47, 638 INFO TransactionFactoryFactory: 31-Using 
default tran 

saction strategy (direct JDBC transactions) 

[java]00: 21: 47, 646 INFO TransactionManagerLookupFactory: 33-No 
Transacti 

onManagerLookup configured (in JTA environment, use of read-write 
or transaction 

al second-level cache is not recommended) 

[java]00: 21: 47, 649 INFO SettingsFactory: 143-Automatic flush 
during befo 

reCompletion () : disabled 

[java]00: 21: 47, 650 INFO SettingsFactory: 147-Automatic session 
close at 

end of transaction: disabled 

[java]00: 21: 47, 657 INFO SettingsFactory: 154-JDBC batch size: 
15 

[java]00: 21: 47, 659 INFO SettingsFactory: 157-JDBC batch updates 
for vers 

ioned data: disabled 

[java]00: 21: 47, 664 INFO SettingsFactory: 162-Scrollable result 
sets: ena 

bled 

[java]00: 21: 47, 666 INFO SettingsFactory: 170-JDBC3 
getGeneratedKeys () : d 

isabled 

[java]00: 21: 47, 668 INFO SettingsFactory: 178-Connection release 
mode: au 

to 

[java]00: 21: 47, 671 INFO SettingsFactory: 205-Default batch 
fetch size: 1 

[java]00: 21: 47, 678 INFO SettingsFactory: 209-Generate SQL with 
comments: 

disabled 

[java]00: 21: 47, 680 INFO SettingsFactory: 213-Order SQL updates 
by primar 

y key: disabled 

[java]00: 21: 47, 681 INFO SettingsFactory: 217-Order SQL inserts 
for batch 

ing: disabled 

[java]00: 21: 47, 684 INFO SettingsFactory: 386-Query translator: 
org.hiber 

nate.hql.ast.ASTQueryTranslatorFactory 

[java]00: 21: 47, 690 INFO ASTQueryTranslatorFactory: 24-Using 
ASTQueryTran 

slatorFactory 


[java]00: 21: 47, 694 INFO SettingsFactory: 225-Query language 
substitution 

s: {} 

[java]00: 21: 47, 695 INFO SettingsFactory: 230-JPA-QL strict 
compliance: d 

isabled 

[java]00: 21: 47, 702 INFO SettingsFactory: 235-Second-level 
cache: enabled 

[java]00: 21: 47, 704 INFO SettingsFactory: 239-Query cache: 
disabled 

[java]00: 21: 47, 706 INFO SettingsFactory: 373-Cache provider: 
org.hiberna 

te.cache.NoCacheProvider 


[java]00: 21: 47, 707 INFO SettingsFactory: 254-Optimize cache for 


minimal 
puts: disabled 


[java]00: 21: 47, 709 INFO SettingsFactory: 263-Structured second- 


level cac 
he entries: disabled 


[java]00: 21: 47, 724 INFO SettingsFactory: 283-Echoing all SQL to 


stdout 

[java]00: 21: 47, 731 INFO SettingsFactory: 290-Statistics: 
disabled 

[java]00: 21: 47, 732 INFO SettingsFactory: 294-Deleted entity 
synthetic id 

entifier rollback: disabled 

[java]00: 21: 47, 734 INFO SettingsFactory: 309-Default entity- 
mode: pojo 

[java]00: 21: 47, 735 INFO SettingsFactory: 313-Named query 
checking: enab 

led 

[java]00: 21: 47, 838 INFO SessionFactoryImpl: 161-building 
session factory 

[java]00: 21: 48, 464 INFO SessionFactoryObjectFactory: 82-Not 
binding fact 

ory to JNDI, no JNDI name configured 

[java]Hibernate: insert into TRACK (TRACK_ID, title, filePath, 
playTime, a 

dded, volume) values (null, ?, ?, ?, ?, ?) 

[java]Hibernate: call identity () 

[java]Hibernate: insert into TRACK (TRACK_ID, title, filePath, 
playTime, a 

dded, volume) values (null, ?, ?, ?, ?, ?) 

[java]Hibernate: call identity () 

[java]Hibernate: insert into TRACK (TRACK_ID, title, filePath, 
playTime, a 

dded, volume) values (null, ?, ?, ?, ?, ?) 

[java]Hibernate: call identity () 


[java]00: 21: 49, 365 INFO SessionFactoryImpl: 769-closing 

[java]00: 21: 49, 369 INFO DriverManagerConnectionProvider: 147- 
cleaning up 

connection pool: jdbc: hsqldb: data/music 

BUILD SUCCESSFUL 

Total time: 2 seconds 


ZETTAF 


如 果 你 查看 Hibernate 打 印 输出 的 所 有 消息 (因为 我 们 打开 了 日 志 
的 "info" 级 别 的 输出 标志 ) ， 你 可 以 看 到 我 们 的 测试 类 会 启动 
Hibernate， 加 载 Track 类 的 映射 信息 ， 打 开 一 个 持久 会 话 (persistence 
session) 以 连接 相关 的 HSQLDB 数 据 库 ， 再 创建 一 些 实例 ， 并 用 会 话 
将 它们 持久 化 保存 到 TRACK 数据 库 表 中 。 接 着 ， 再 关闭 这 个 会 话 和 数 
据 库 连接 ， 以 确保 数据 正确 地 完成 存储 。 


运行 完 这 个 测试 以 后 ， 你 可 以 用 ant db 看 一 看 数据 库 的 内 容 。 现 
在 ， 你 应 该 可 以 在 TRACK 表 中 看 到 三 条 记 杂 ， 如 图 3-1 所 示 (在 窗口 顶 
部 的 文本 框 中 输入 查询 语句 ， 点 击 "Execute" 按 钮 。 也 可 以 选择 末 单 栏 
中 的 "Command" "Select"， 会 得 到 一 个 SQL 命 令 的 框架 和 语法 说 明文 
$) 


ece HSQL Database Manager nh 


E jdbc: hsqlgb. datasmusic SELELT FROM TRACK 

@ TRACK 
schema: PUBLIC Clear Execute 
B TRACK_ID 
& TITLE 
E FILEPATH TRACK_ID|TITLE FILEPATH [PLAYTIME ADDED 
© PLATINE 1 Russian Trance val falbum610/trackO2.mp3 00:03:30 2007-06 
= nigro 2 Video Killed the Radivel? /albume Li ftrackl?2 mpi 00:03:49 FOO7-06 
traces 3 Gravity's Angel volz album 175 MrackO3. mp3 00:06:06 2007-06 

& Properties 


图 3-1 持久 保存 到 TRACK 表 中 的 测试 数据 


现在 ， 我 们 停 下 来 一 会 儿 ， 反 思 一 个 事实 一 我 们 没有 编写 任何 连 
接 数据 库 或 执行 SQL 命令 的 代码 。 再 回想 上 一 下 ， 我 们 甚至 也 不 必 杀 
自 创 建 数据 库 表 和 封装 数据 的 Track 对 象 。 但 是 ， 图 3-1 中 查询 输出 显示 
的 那些 整整 齐 齐 的 数据 表明 ， 我 们 简短 的 测试 程序 确实 已 经 创建 了 Java 
对 象 ， 并 正确 地 进行 了 持久 化 处 理 。 和 希望 你 可 以 因此 而 认同 ， 作 为 一 
种 持久 化 服务 ，Hibernate 真 的 功能 强大 、 使 用 方便 。 作 为 一 种 免费 


的 、 轻 型 的 工具 ，Hibernate 确 实 为 我 们 完成 了 很 多 工作 ， 这 一 切 又 是 
那么 的 快捷 而 简单 ! 


如 果 你 以 前 直接 用 过 JDBC， 尤 其 是 当 你 还 不 太 熟 悉 它 时 ， 你 可 能 
习惯 使 用 数据 库 驱 动 程序 的 "auto-commit”( 自 动 提交 ) 模式 ， 而 不 是 
使 用 数据 库 事务 处 理 (transaction) 。Hibernate 同 样 认为 这 是 构造 应 用 
程序 的 一 种 错误 方法 ,“ 目 动 提交 ?模式 惟一 有 意义 的 使 用 场合 就 是 供 


人 使 用 的 数据 库 控 制 台 环境 。 所 以 ， 在 Hibernate 应 用 中 ， 持 久 化 操作 
总 是 需要 使 用 事务 处 理 。 


如 第 1 章 所 述 ， 你 可 以 在 data 目 录 下 的 music.script 文 件 中 直接 查看 
用 于 创建 数据 的 SQL 语 句 ， 如 例 3-6 所 示 。 


例 3-6: 查看 原始 的 数据 库 脚 本 文件 


%cat data/music.script 
CREATE SCHEMA PUBLIC AUTHORIZATION DBA 
CREATE MEMORY TABLE TRACK (TRACK_ID INTEGER GENERATED BY DEFAULT 
AS IDENTITY (STAR 
T WITH 1) NOT NULL PRIMARY KEY, TITLE VARCHAR (255) NOT NULL, 
FILEPATH VARCHAR (255) 
NOT NULL, PLAYTIME TIME, ADDED DATE, VOLUME SMALLINT NOT NULL) 
ALTER TABLE TRACK ALTER COLUMN TRACK_ID RESTART WITH 4 
CREATE USER SA PASSWORD"" 
GRANT DBA TO SA 
SET WRITE_DELAY 10 
SET SCHEMA PUBLIC 
INSERT INTO TRACK VALUES (1, 'Russian 
Trance', 'vol2/album610/track02.mp3', '00: 03: 3 
@', '2007-06-17', 0) 
INSERT INTO TRACK VALUES (2, 'Video Killed the Radio 
Star', 'vol2/album611/tracki2. 
mp3', '00: 03: 49', '2007-06-17', 0) 
INSERT INTO TRACK VALUES (3, "Gravity''s 
Angel', 'vol2/album175/track03.mp3', '00: 06 
: 06', '2007-06-17', 0) 


最 后 三 条 语句 是 我 们 的 TRACK 表 的 数据 行 。 脚 本 的 最 前 面包 含 了 
当 创 建新 的 数据 库 时 ， 默 认 使 用 的 模式 和 用 户 名 。 (当然 ， 在 实际 应 
用 环境 中 ， 你 可 能 需要 修改 这 些 身份 验证 信息 ， 除 非 数 据 库 只 供 内 存 


访问 (in-memory access) 。) 


注意 : 想 多 学 点 HSQLDB? 我 们 支持 你 ! 


其 他 


对 象 和 其 他 对 象 之 间 的 关系 呢 ? 对 象 集合 (collection) Ye? we 
错 ， 有 些 情况 会 让 持久 化 处 理 更 具 挑 战 性 (如 果 做 得 好 的 话 ， 束 相当 
有 价值 ) 。Hibernate 能 妥善 处 理 这 种 关联 性 。 事 实 上 ， 我 们 不 需要 为 
此 人 花费 什么 力气 。 在 第 4 章 将 会 讨论 这 一 点 。 就 目前 而 言 ， 让 我 们 移 看 
看 如 何 将 先前 会 话 中 持久 保存 的 对 象 取出 来 。 


[1] http:/www.oreilly.com/catalog/9780596517724/. 

[2] 虽然 codegen 构 建 目 标 要 依赖 prepare 构 建 目 标 ， 但 第 一 次 处 理 示 例 目 
录 时 ， 你 需要 先 显 式 地 运行 prepare 以 创建 正确 的 类 路 径 结构 ， 这 样 Ant 
以 后 才 可 以 正常 工作 ， 如 第 2 章 的 2.3 节 所 述 。 


检索 持久 化 对 象 


现在 ， 是 该 来 个 180 度 大 转弯 ， 看 看 如 何 从 数据 库 加 载 数据 到 Java 
对 象 中 。 


使 用 Hibernate 查 询 语言 (Hibernate Query Language, HQL) ， 就 能 
以 面向 对 象 的 方法 来 检索 映射 到 数据 库 表 的 内 容 。 这 些 数据 可 以 是 以 
前 的 会 话 中 保存 的 持久 化 对 象 ， 也 可 以 是 完全 来 自 于 应 用 程序 代码 以 
外 的 数据 。 


应 该 怎么 做 


例 3-7 演 示 了 一 个 程序 ， 对 我 们 刚才 创建 的 测试 数据 进行 商 单 的 碍 
询 。 整 体 的 结构 看 起 来 应 该 非常 熟悉 ， 因 为 所 有 的 Hibernate 设 置 都 和 
上 一 个 程序 相同 。 


例 3-7: 数据 检索 测试 QueryTest.java 


package com.oreilly.hh; 

import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; 


*Retrieve data as objects 
X7 


public class QueryTest{ 

A 

*Retrieve any tracks that fit in the specified amount of time. 

* 

*@param length the maximum playing time for tracks to be 
returned. 

*@param session the Hibernate session that can retrieve data. 

*@return a list of{@link Track}s meeting the length restriction. 

*/ 

public static List tracksNoLongerThan (Time length, Session 
session) {0 

Query query=session.createQuery ("from Track as track"+ 

"where track.playTime<=?") ; 

query.setParameter (0, length, Hibernate.TIME) ; 

return query.list () ; 

} 

JER 

*Look up and print some tracks when invoked from the command 
line. 

*/ 

public static void main (String args[]) throws Exception{ 

//Create a configuration based on the properties file we've put 

//in the standard place. 

Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 

SessionFactory sessionFactory=config.buildSessionFactory () ; 

//Ask for a session using the JDBC information we've configured 

Session session=sessionFactory.openSession () ; 

try{@ 

//Print the tracks that will fit in five minutes 

List tracks=tracksNoLongerThan (Time.valueOf ("00: 05: 00") , 

session) ; 

for (ListIterator iter=tracks.listIterator () ; 

iter.hasNext () ; ) { 

Track aTrack= (Track) iter.next () ; 

System.out.println ("Track: \""+aTrack.getTitle () + 

"\", "taTrack.getPlayTime () ) ; 

} 

}finally{ 

//No matter what, close the session 

session.close () ; 

} 

//Clean up after ourselves 

sessionFactory.close () ; 

} 

} 


同样 ， 如 例 3-8 所 示 ， 在 build.xml 的 末尾 (在 project 的 关闭 标签 以 
BD 添加 一 个 构建 目标 ， 以 运行 这 个 测试 。 


例 3-8: 调用 查询 测试 的 Ant 构 建 目标 


<target name="qtest"description="Run a simple Hibernate query" 
depends="compile" > 

<java classname="com.oreilly.hh.QueryTest"fork="true" > 
<classpath refid="project.class.path"/> 

</java> 

</target> 


准备 好 以 后 ， 只 要 输入 ant qtest， 束 可 以 检索 出 数据 并 显示 出 来 ， 

结 采 如 例 3-9 所 示 。 为 了 市 省 输出 结 末 占 据 的 空间 ， 我 们 编辑 
log4j.properties 文 件 ， 将 所 有 "info" 级 别 的 信息 输出 都 关 掉 ， 因 为 这 
信息 和 前 一 个 例子 没有 差别 。 你 可 以 修改 一 下 这 一 


10g4j.logger .org.hibernate=info 

将 Info 替换 成 warn: 

log4j.logger .org.hibernate=warn 

例 3-9: 运行 查询 测试 

%ant qtest 

Buildfile: build.xml 

prepare: 

[copy]Copying 1 file to/Users/jim/svn/oreilly/hib_dev_2e/current 

/examples/ch03/classes 

compile: 

[javac]Compiling 1 source file 
to/Users/jim/svn/oreilly/hib_dev_2e 

/current/examples/ch03/classes 

qtest: 

[java]Hibernate: select trackO0_.TRACK_ID as TRACK1 0 _， 
trackO_.title as ti 

tleO_, trackO_.filePath as filePathO_, trackO_.playTime as 
playTimeO_, trackO_.a 


dded as added0_ ，track0 .volume as volume0_from TRACK 
trackO_where track0_.pla 

yTime <=? 

[java]Track: "Russian Trance", 00: 03: 30 

[java]Track: "Video Killed the Radio Star", 00: 03: 49 

BUILD SUCCESSFUL 

Total time: 2 seconds 


AEE TAP A 


@ 我 们 先是 定义 了 一 个 工具 方法 : tracksNoLongerThan () , HE 
执行 真正 的 Hibernate 查 询 ， 取 回 播放 时 间 小 于 或 等 于 参数 指定 的 值 的 
任何 曲目 。 注 意 HQL (Hibernate 根 据 SQL 独 创 的 查询 语言 ) 文 持 参数 
占 位 符 ， 非 常 像 JDBC 中 的 PreparedStatement。 而 且 ， 与 之 类 似 的 是 ， 
使 用 参数 占 位 符 更 适合 于 通过 字符 串 处 理 将 所 有 查询 集中 在 一 起 (万 
其 是 这 样 可 以 免 受 SQL 注 入 的 攻击 ) 。 不 过 ， 你 将 看 到 ，Hibernate 提 
供 了 在 Java 中 更 好 的 使 用 查询 的 方法 。 


查询 本 身 看 起 来 有 些 古 怪 。 它 以 from 作 为 开始 ， 而 不 是 你 可 能 期 
竺 的 像 select something 之 类 的 语句 。 昌 然 你 确实 可 以 使 用 与 标准 SQL 
更 加 类 似 的 格式 ， 而 且 当 需要 在 查询 中 从 一 个 对 象 提取 出 单独 的 属性 
时 ， 也 只 能 这 么 做 ， 如 末 你 想 获 取 整 个 对 象 ， 就 可 以 使 用 这 种 更 简 涪 
的 语法 。 


还 要 注意 的 是 ， 碍 询 是 按照 映射 的 Java 对 象 和 属性 来 表达 的 ， 而 
不 是 数据 表 和 列 。 在 这 个 例子 中 这 一 区 别 还 不 明显 ， 因 为 对 象 和 数据 


表 的 名 称 都 相同 ， 属 性 和 列 的 名 称 也 都 相同 ， 但 查询 确实 是 按照 对 象 
和 属性 来 表达 的 。 保 持 二 者 的 名 称 一 致 是 一 种 相当 目 然 的 选择 ， 如 采 
使 用 Hibernate 来 生成 数据 库 模 式 和 数据 对 象 ， 结 果 也 总 是 这 样 ， 除 非 
你 明确 地 告诉 Hibernate 使 用 不 同 的 列 名 称 。 


当 你 使 用 的 十 以 前 整 有 的 数据 库 和 对 象 时 ， 束 应 该 特别 留言 HQL 
查询 引用 的 是 对 象 属性 ， 而 不 是 数据 库 表 的 列 。 


此 外 ， 吏 像 在 SQL 中 一 样 ， 可 以 为 数据 库 表 和 列 起 其 他 的 别名 。 
在 HQL 中 ， 也 可 以 为 类 起 别名 ， 以 方便 选择 它们 的 属性 或 增加 约束 条 
件 。 当 然 ， 在 这 个 简单 的 例子 中 不 会 看 到 这 种 用 法 ， 但 是 如 采 你 深入 
研究 附 邓 EE 中 的 内 容 ， 肯 定 会 遇 到 这 种 用 法 。 


@ 这 个 程序 的 其 他 部 分 看 起 来 可 能 和 上 一 个 例子 类 似 。 这 里 我 们 
简化 了 try 块 的 处 理 ， 因 为 没有 改变 任何 数据 ， 所 以 就 不 需要 显 式 地 访 
问 事务 。 我 们 仍旧 使 用 try 块 ， 这 样 束 能 够 有 一 个 finaly 子 句 ， 以 清晰 
地 关闭 会 话 。 代 码 体 本 吴 很 简单 ， 调 用 我 们 的 查询 方法 以 请 求 播放 时 
间 小 于 或 等 于 5 分 钟 的 所 有 曲目 ， 接 着 再 授 历 结 末 中 的 Track 对 象 ， 分 
别 打印 它们 的 标题 和 播放 时 间 。 


既然 我 们 已 经 关 挥 了 Hibernate 内 部 "info" 级 别 的 日 志 输 出 ， 那 么 我 
们 在 hibernate.cfg.xml 中 配置 的 SQL 调 试 输出 就 更 容易 定位 了 。 输 出 
中 "qtest:" 部 分 的 第 1 行 并 不 是 我 们 自己 在 QueryTest.java 中 编写 的 ， 我 


们 看 到 的 SQL 语句 是 Hibernate 生 成 的 ， 以 实现 我 们 请 求 的 HQL 碍 询 。 
这 些 内 幕 信息 很 有 趣 吧 ! 如 果 你 对 这 些 信息 也 不 感 兴趣 ， 则 可 以 将 
show_sql 属 性 设置 为 false， 就 不 会 看 到 它们 了 。 


其 他 


如 果 你 已 经 对 数据 创建 脚本 生成 的 数据 进行 了 修改 ， 现 在 义 想 清 
空 数据 库 ， 以 一 种 “干净 的 状态 ” (clean slate) 来 进行 测试 ， 那 么 你 需 
ERR Wie FE VCS fT ant schema 命 令 。 这 样 会 将 原 有 的 TRACK 表 完 全 
删除 ， 并 重新 创建 新 的 TRACK 表 ， 使 其 处 于 最 原始 的 空 状态 。 除非 你 
真 的 需要 这 样 ， 否 则 不 要 轻易 这 样 做 ! 


如 果 你 想 选 择 性 地 删除 一 些 数据 ， 则 或 者 通过 HSQLDB UI (ant 
db) 里 的 SQL 命令 ; 或 者 移 进行 一 定 的 查询 ， 检 索 回 你 想 删 除 的 对 
象 。 在 取得 持久 化 对 象 的 引用 以 后 ， 可 以 将 该 对 象 的 引用 传递 给 
Session 的 delete () 方法 ， 这 样 就 可 以 将 它 从 数据 库 中 删除 了 : 


session.delete (aTrack) ; 


直到 aTrack 变 量 超出 其 作用 域 范围 (scope) 或 者 重新 赋值 以 前 ， 
你 的 程序 还 至 少 有 一 个 指向 这 个 被 删除 对 象 的 引用 。 因 此 ， 就 概念 上 
而 言 ， 理 解 delete () 方法 最 简单 的 方式 就 是 将 其 视 为 把 一 个 持久 化 对 
象 (persistent object) 转变 为 一 个 瞬时 对 象 (transient object) 。 


删除 对 象 的 另外 一 种 方法 就 编写 一 条 可 以 匹配 多 个 对 象 的 HQL 删 
从 查询 语句 。 这 样 可 以 一 次 性 删除 多 个 持久 化 对 象 ， 而 不 管 这 些 对 象 
是 否 在 内 存 中 ， 还 不 用 自己 写 循 环 。 除 了 使 用 ant schema 命 令 ， 改 用 
Java 方 法 ， 以 较 “ 温 和 ”的 手法 来 清除 掉 所 有 曲目 时 ， 就 可 以 像 这 样 
写 : 


ea 


Query query=session.createQuery ("delete from Track") ; 
query.executeUpdate () ; 


不 要 把 了 ， 无 论 采 用 哪 种 方法 ， 都 得 将 数据 处 理 的 代码 放 在 
Hibernate 事 务 处 理 以 内 ， 如 果 想 让 修改 的 内 容 “ 固 定 ” 下 来 ， 束 得 提交 


(commit) 该 事务 。 


建立 得 询 的 更 好 方法 


如 本 章 前 面 所 述 ，HQL 让 你 不 必 使 用 JDBC 风 格 的 查询 占 位 符 ， 恕 
能 方便 地 将 参数 整合 到 查询 中 。 可 以 使 用 命名 参数 (named 
parameter) 和 命名 查询 (named query) 来 让 程序 更 易于 阅读 和 维护 。 


为 何在 意 


命名 参数 之 所 以 可 以 让 代码 更 容易 理解 ， 有 是 因为 不 管 在 碍 询 本 身 
内 部 ， 还 是 在 建立 查询 的 Java 代 码 内 部 ， 都 请 晰 地 表达 了 参数 的 意 
o 这 种 目 描述 性 (self-documenting) 的 本 质 就 是 命名 参数 的 价值 所 
在 ， 同 时 也 减少 了 引发 错误 的 潜在 可 能 ， 因 为 使 用 命名 参数 时 ， 你 不 
用 计算 SQL 语句 中 去 号 和 问 吕 的 个 数 。 可 以 在 一 个 单独 的 查询 中 多 次 
使 用 相同 的 参数 ， 这 样 在 一 定 程 度 上 也 可 以 提高 程序 的 性 能 。 


命名 查询 可 以 将 查询 完全 从 Java 代 码 中 分 离 出 来 。 将 查询 语句 和 
Java 源 代码 分 离开 ， 会 使 其 更 易于 阅读 和 编辑 ， 因 为 得 询 语句 不 再 是 
原来 一 大 堆 跨 越 多 行 的 Java 字 符 串 序列 ， 且 交织 厦大 量 的 问号 、 反 和 伴 
线 以 及 其 他 Java 标 点 符号 。 第 一 次 输入 这 样 的 语句 是 相当 麻烦 的 ， 但 
征 如 采 你 需要 对 这 种 藤 入 在 程序 中 的 碍 询 做 重要 的 修改 时 ， 束 得 四 处 
移动 问号 和 加 号 ， 尽 可 能 让 语句 行 再 次 在 适当 的 位 置 断 开 。 


DIKE A ti 


对 于 Hibernate 而 言 ， 这 些 能 力 的 关键 就 是 Query 接 口 。 我 们 在 例 3- 
7 中 就 已 经 使 用 过 这 个 接口 ， 因 为 从 Hibernate 3 开始 ，Query 接 口 是 疏 
一 Hibernate 不 反对 使 用 (nondeprecated) 的 执行 查询 的 接口 。 所 以 ， 
和 本 节 介 绍 的 其 他 功能 相 比 ， 现 在 更 容易 了 。 


我 们 先 修改 查询 语句 ， 使 用 命名 参数 ， 如 例 3-10 所 示 。 (对 于 这 
种 只 有 单一 参数 的 查询 语句 而 言 ， 这 并 不 古 什么 难事 ， 但 宝 吐 的 是 从 
现在 起 束 养 成 正确 的 习惯 。 当 你 开始 为 实际 的 项 目 打 造 一 大 堆 难 以 看 
清 的 得 询 语句 时 ， 你 会 很 感激 这 个 习惯 的 ! ) 


例 3-10: 修改 查询 语句 ， 改 用 命名 参数 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.createQuery ("from Track as track"+ 

"where track.playTime<=: length") ; 

query.setTime ("length", length) ; 

return query.list () ; 


在 查询 语句 内 部 ， 命 名 参数 通过 在 它们 的 名 称 前 面 加 一 个 冒 
号 “:” 作 为 标识 。 此 处 ， 我 们 将 “?” 号 大 换 为 ":length"。 会 话 对 象 提供 了 
一 个 createQuery () 方法 ， 可 以 返回 一 个 Query 接 口 的 实现 ， 以 供 我 们 
使 用 。 为 了 设置 命名 参数 的 值 ，Query 提 供 了 一 整套 类 型 安全 的 方法 。 


这 里 ， 我 们 传递 的 是 一 个 Time 类 型 的 值 ， 所 以 我 们 使 用 了 setTime () 
方法 。 即 使 在 如 此 简单 的 情况 下 ， 和 原来 的 查询 语句 相 比 ， 使 用 命名 
参数 以 后 的 语法 更 为 目 然 和 方便 阅读 。 如 果 我 们 原来 传递 参数 使 用 的 
是 值 和 类 型 的 匿名 数组 (anonymous array) ”( 必 需 传递 多 个 参数 ) ， 
这 样 的 改进 束 显 得 更 重要 了 了。 此外， 我们 又 多 加 了 一 层 编 译 时 
(compile-time) 的 类 型 检查 ， 这 总 是 很 受 开 发 人 员 欢 迎 的 调整 。 


运行 这 一 版 本 的 程序 产生 的 结果 和 原来 的 程序 完全 相同 。 


那么 ， 我 们 怎么 将 查询 语句 文本 放 到 Java 源 代码 以 外 昵 ? 同样 ， 
这 个 查询 太 人 简单 了 ， 以 至 于 这 样 做 的 需要 不 像 在 实际 项 目 中 那样 令 人 
印象 深刻 。 但 是 ， 这 是 处 理 查 询 语句 的 最 佳 方法 ， 所 以 开始 练习 吧 ! 
号 像 你 预料 的 那样 ， 我 们 存放 查询 语句 的 地 方 整 是 映 喘 文 档 内 部 。 例 
3-11 显 示 了 映射 文档 中 的 查询 语句 。 我 们 必须 使 用 有 点 举重 的 CDATA 
结构 ， 因 为 查询 语句 中 可 能 会 包含 一 些 破坏 XML 解析 天 处 理 的 字符 
(例如 ， 像 <“< "这样 的 字符 ) 。 


例 3-11: 映射 文档 中 的 查询 语句 


<query name="com.oreilly.hh.tracksNoLongerThan"> 
<! [CDATA[ 

from Track as track 

where track.playTime<=: length 

]] > 

</query> 


将 这 些 内 容 放 在 Track.hbm.xml 中 类 定义 的 闭合 标签 (</class > ) 
之 后 (就 在 </hibernate-mapping> 那 一 行 的 前 面 ) 。 然 后 ， 对 
QueryTest.java 做 最 后 一 次 修改 ， 如 例 3-12 所 示 。 同 样 地 ， 程 序 产生 的 
结 末 和 最 初版 本 完全 相同 ， 只 十 现在 组 织 得 更 好 。 如 采 我 们 需要 使 用 
更 复杂 的 查询 ， 有 这 些 基础 已 经 相当 好 了 。 


例 3-12: 查询 方法 的 最 终 版 本 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery ( 

"com.oreilly.hh.tracksNoLongerThan") ; 


query.setTime ("length", length) ; 
return query.list () ; 


除了 这 里 探讨 的 内 容 以 外 ，Query 接 口 还 有 很 多 其 他 有 用 的 功能 。 
可 以 使 用 接口 控制 要 取 回 多 少 条 记录 〈 并 可 以 指定 特定 的 记录 行 ) 。 
如 果 JDBC 驱 动 程序 支持 可 滚动 的 (scrollable) ResultSet， 通 过 Query 
接口 也 可 以 使 用 这 一 功能 。 相 关 更 多 的 细节 ， 可 以 查阅 JavaDoc 和 
Hibernate 的 参考 手册 。 


其 他 


完全 不 使 用 类 SQL 语言 ? 或 者 深入 HQL， 探 索 更 为 复杂 的 查询 ? 
这 两 种 方法 都 是 本 书后 面 将 要 介绍 的 内 容 。 


第 8 章 会 讨论 条 件 查询 (criteria query) 。 条 件 查询 是 一 种 很 有 趣 
的 机 制 ， 可 以 让 你 用 普通 的 Java API 表 达 出 想 要 对 实体 施加 的 限制 条 
件 。 这 样 下 可 以 构建 Java 对 象 来 表示 你 想 要 找到 的 数据 ， 对 于 非 数据 
库 专 家 来 说 ， 这 种 方法 更 容易 理解 。 这 种 方法 还 可 以 让 你 利用 IDE 的 
代码 完成 (code completion) 功能 作为 一 种 辅助 编辑 方法 ， 甚 至 可 以 
提供 编译 时 的 语法 检查 。 此 外 ，Hibernate 还 支持 一 种 “按照 例子 来 查 
询 ” (query by example) 的 方法 ， 就 是 要 找 什 么 对 象 ， 先 提供 与 之 类 
似 的 对 象 例子 。 这 些 对 实现 应 用 程序 的 查询 搜索 接口 都 很 有 帮助 。 


想 多 看 点 HQL 的 SQL 老手 可 以 跳 到 第 9 章 ， 那 一 章 将 讨论 HQL 的 更 
多 其 他 能 力 和 独特 功能 。 就 目前 而 言 ， 接 下 来 我 们 要 继续 探索 对 象 / 关 
系 映 射 中 如 何 处 理 对 和 象 之 间 的 相互 关系 ， 这 在 任何 稍 复 杂 的 实际 应 用 
中 都 会 遇 到 o 


第 4 章 ”集合 与 关联 

不 ， 这 些 不 是 关于 理论 的 东西 。 我 们 已 经 看 到 让 单独 的 对 象 进出 
数据 库 是 多 么 容易 ， 现 在 应 该 来 看 看 如 何 处 理 对 象 之 间 的 分 组 和 关 
系 。 令 人 高 兴 的 是 ， 这 也 没什么 难 的 。 


集合 的 映 册 


在 任何 真实 的 应 用 程序 中 ， 总 要 管理 对 象 的 列表 或 分 组 。Java 提 供 
了 一 套 健壮 而 功能 丰富 的 类 来 帮助 实现 这 些 应 用 : 集合 (Collection) 
工具 。 为 了 将 数据 库 关 系 映 射 到 集合 中 ，Hibernate 也 提供 了 一 些 很 自 
然 的 实现 方法 。 而 且 它 们 的 使 用 通常 也 非常 方便 。 不 过 ， 你 得 注意 Java 

合 和 Hibernate 集 合 在 语义 上 的 一 些 差别 ， 当 然 ， 这 些 差 别 很 小 。 事 
实 上 最 大 的 差别 是 Java 集 合 没有 提供 "bag" (AL) 的 定义 ， 这 可 能 多 少 
会 让 一 些 经 验 丰富 的 数据 库 设计 师 感到 失望 。 这 一 缺陷 并 不 是 
Hibernate 的 钳 ，Hibernate 甚 至 也 做 一 些 努力 ， 以 作为 解决 这 一 问题 的 变 


通 方案 (work around) 。 


注意 : Bag 很 像 Set， 只 不 过 相同 的 值 可 以 多 次 出 现 。 


这 些 抽象 概念 就 点 到 为 上 上 ! Hibernate 参 考 手 册 对 整个 bag 问 题 已 经 
做 了 详尽 的 讨论 ， 所 以 我 们 在 这 里 不 做 介绍 ， 直 接 看 一 个 集合 映射 的 


示例 (就 此 示例 而 言 ， 关 系数 据 库 和 Java 模 型 配合 得 相当 好 ) 。 在 第 2 
章 Track 示 例 的 基础 上 继续 构建 新 的 功能 ， 将 曲目 分 组 成 专辑 (album) 
看 起 来 似乎 很 自然 ， 但 对 于 学 习 来 说 ， 这 并 不 是 最 简单 的 起 点 。 因 为 
组 成 专辑 需要 牵涉 到 记录 其 他 额外 的 信息 ， 例 如 曲目 是 从 哪 张 唱片 来 
的 〈 对 于 那些 包含 数 张 唱片 的 专辑 而 言 ) ， 以 及 其 他 类 似 的 细节 信 
息 。 所 以 ， 我 们 先 把 艺人 (artist) 的 信息 加 进 数 据 库 吧 。 


注意 : 和 以 前 一 样 ， 这 些 示例 假设 你 已 经 按照 前 几 章 的 步骤 做 好 
了 基础 工作 。 如 采 还 没有 ， 可 以 下 载 示例 的 产 代 码 作为 起 点 。 


要 记录 的 亏 人 信息 相当 简单， 至 少 刚 开 始 羡 这 样 的 。 爷 从 乞 人 的 
姓名 开始 。 可 以 为 每 个 曲目 分 配 一 组 艺人 ， 这 样 ， 我 们 就 知道 应 该 找 
谁 表示 感谢 或 不 满 ， 还 可 以 找 出 你 喜欢 的 某 位 艺人 的 所 有 曲目 。 (A 
许 为 一 个 曲目 分 配 多 位 艺人 是 相当 重要 的 ， 但 很 少 有 音乐 管理 程序 做 
到 了 这 一 点 。 新 增 加 一 个 链接 以 记录 曲目 的 作者 的 工作 就 留 给 读者 ， 
以 作为 读者 理解 这 个 示例 之 后 的 练习 吧 。 ) 


应 该 怎么 做 


就 目前 而 言 ， 我 们 的 Artist 类 只 需要 一 个 name 属 性 就 足够 了 ( 当 
然 ， 还 有 它 的 主键 属性 (id) ) 。 为 它 建立 映射 文档 也 相当 容易 。 在 
Track 映射 文档 所 在 的 目 孙 中 创建 一 个 名 为 Artisthbm.xml 的 文件 ， 其 内 
容 如 例 4-1 所 示 。 


例 4-1: Artist 类 的 映射 文档 


<?xml version="1.0"?> 

<! DOCTYPE hibernate-mapping PUBLIC"-//Hibernate/Hibernate 
Mapping DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" > 

<hibernate-mapping > 

<class name="com.oreilly.hh.data.Artist"table="ARTIST" > 

<meta attribute="class-description" > 

Represents an artist who is associated with a track or album. 

@author Jim Elliott (with help from Hibernate) 

</meta> 

<id name="id"type="int"column="ARTIST_ID" > 

<meta attribute="scope-set">protected</meta> 

<generator class="native"/> 

</id> 

<property name="name"type="string">@ 

<meta attribute="use-in-tostring">true</meta> 

<column name="NAME"not - 
null="true"unique="true"index="ARTIST_NAME"/ > 

</property> 

<set name="tracks"table="TRACK_ARTISTS"inverse="true">@ 

<meta attribute="field-description">Tracks by this artist</meta 
> 日 

<key column="ARTIST_ID"/> 

<many-to-many 
class="com.oreilly.hh.data.Track"column="TRACK_ID"/ > 

</set> 

</class> 

</hibernate-mapping > 


@ 我 们 对 name 属 性 的 映射 引入 了 一 对 限制 标签 ， 分 别 用 于 配置 代 
码 生 成 和 模式 生成 过 程 。use-in-tostring 这 个 meta 标 签 会 让 生成 的 Java 类 
包含 一 个 定制 的 toString () 方法 ， 用 于 在 输出 时 显示 艺人 的 名 字 ， 以 
及 神秘 的 散 列 码 (hash code) ， 以 辅助 调试 (生成 结果 如 例 4-4 底 部 所 
示 ) 。 扩 展 column 的 各 属性 ， 使 其 成 为 一 个 更 加 完整 的 标签 ， 让 我 们 


对 列 属性 进行 更 细 和 粒度 的 控制 。 在 这 个 例子 中 ， 我 们 用 这 个 标签 增加 
了 一 个 索引 ， 可 以 提高 按 艺人 名 字 查 询 和 排序 的 效率 。 


@ 注 意 ， 在 这 个 文件 中 我 们 可 以 很 自然 地 表达 一 个 艺人 与 一 个 或 

多 个 曲目 关联 的 事实 。 这 段 映 射 告诉 Hibernate， 为 Artist 类 增加 一 个 名 
为 tracks 的 属性 ， 它 的 类 型 是 java.util.Set 的 一 个 实现 。 这 会 使 用 一 个 新 
的 名 为 TRACK_ARTISTS 的 表 来 为 该 Artist 链 接 由 它 负责 的 Track 对 象 。 
属性 inverse=true 稍 后 在 例 4-3 的 讨论 中 再 详细 解释 这 种 关联 的 双向 性 的 
本 质 。 我 们 刚才 提 到 的 TRACK_ARTISTS 表 将 包含 两 列 : TRACK_ID 和 
ARTIST_ID。 在 这 个 表 中 出 现 的 每 一 行 都 意味 着 指定 的 Artist 对 象 和 指 
定 的 Track 对 象 有 一 定 的 关系 。 将 这 种 关联 信息 单独 保存 在 它 自 己 的 表 
中 ， 这 样 就 不 会 限制 多 少 个 曲目 可 以 链接 到 一 个 特定 的 艺人 ， 也 不 会 
限制 多 少 个 艺人 可 以 关联 到 一 个 曲目 。 这 就 是 所 谓 的 “多 对 多 ”关联 。 


为 一 方面 ， 由 于 这 些 关 联 信息 保存 在 一 个 单独 的 表 中 ， 要 获取 天 
于 艺人 或 曲目 的 任何 有 意义 的 信息 ， 就 必须 执行 一 个 连接 查询 。 这 也 
就 是 为 什么 称 这 样 的 表 为 “连接 表 ” (join table) 的 原因 。 它 们 的 所 有 目 
的 束 古 为 了 连接 其 他 的 表 。 


最 后 要 注意 的 是 ， 不 像 我 们 用 数据 库 模 式 定 义 建立 的 其 他 表 ， 
TRACK_ARTISTS 表 没有 任何 相应 的 Java 对 象 。 它 只 是 用 于 实现 Artist 
和 Track 对 象 之 间 的 链接 ， 体 现 为 Artist 的 tracks 属 性 。 


四 除了 普通 的 值 类 型 字段 外 ，field-description meta 标 签 也 可 以 为 集 
合 和 关联 提供 JavaDoc 描 述 。 当 字段 名 称 不 能 完全 自动 文档 化 (self- 
documenting) 时 ， 这 种 方法 就 很 方便 了 。 


如 有 果 对 连接 表 和 多 对 多 关联 之 类 的 概念 还 不 熟悉 ， 那 么 花 些 时 间 
看 看 数据 建 模 的 很 好 的 介绍 是 值得 的 。 对 这 些 概念 的 了 解 也 有 助 于 数 
据 驱 动 的 项 目的 设计 、 理 解 以 及 交流 。George Reese 的 《Java Database 
Best Practices) (O'Reilly) 就 有 这 样 的 介绍 ， 而 且 还 可 以 在 线 阅读 这 
本 书 的 部 分 章节 ， 网 址 是 


http://www.oreilly.com/catalog/javadtabp/chapter/ch02.pdf ° 


由 映射 文档 提供 的 调整 和 配置 选项 (尤其 是 使 用 meta 标 签 时 ) ， 

为 如 何 构建 源 代码 和 数据 库 模 式 带 来 了 很 大 的 灵活 性 。 你 亲 目 编写 这 
些 配 置 文件 所 获得 的 控制 能 力 ， 没 什么 可 以 与 之 相 比 ， 但 是 ， 对 于 大 
多 数 需要 和 应 用 场合 来 说 ， 使 用 映射 驱动 (mapping-driven) 的 生成 工 
具 就 已 经 足够 了 。 这 些 生 成 工具 的 一 个 最 大 优点 就 是 ， 它 们 可 以 免 去 
你 输入 繁琐 的 文件 内 容 ! 创建 好 了 Artist.hbm.xml 文 件 以 后 ， 我 们 需要 
将 它 添加 到 hibernate.cfg.xml 的 映射 资源 部 分 。 在 src 目 录 中 打开 
hibernate.cfg.xml 文 件 ， 添 加 例 4-2 中 用 粗 体 字 显示 的 那 一 行 。 


例 4-2: 将 Artist.hbm.xml 深 加 到 Hibermmate 配 置 文 件 中 


<?xml version='1.0'encoding='utf-8'?> 
<! DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 


"http://hibernate.sourceforge.net/hibernate-configuration- 
3.0.dtd"> 

<hibernate-configuration> 

<session-factory> 


<mapping resource="com/oreilly/hh/data/Track.hbm.xm1l"/> 
<mapping resource="com/oreilly/hh/data/Artist.hbm.xmL"/> 


</session-factory> 
</hibernate-configuration> 


准备 好 后 ， 我 们 也 为 Track 类 增加 一 个 Artists 集 合 。 编 辑 
Track.hbm.xml 文 件 ， 添 加 一 个 新 的 artists 属 性 ， 如 例 4-3 所 示 (新 添加 的 
内 容 以 粗 体 显示 ) 。 


例 4-3: 在 Track 映射 文件 中 增加 一 个 artist 集 合 


<property name="playTime"type="time" > 

<meta attribute="field-description">Playing time</meta> 

</property> 

<set name="artists"table="TRACK_ARTISTS" > 

<key column="TRACK_ID"/> 

<many-to-many 
class="com.oreilly.hh.data.Artist"column="ARTIST_ID"/> 

</set> 

<property name="added"type="date" > 

<meta attribute="field-description">When the track was created 
</meta> 

</property> 


这 样 会 新 增加 一 个 名 为 artists 的 Set 类 型 的 属性 。 它 同样 使 用 例 4-1 
提 到 的 TRACK_ARTISTS 连 搂 数 据 表 来 链接 到 我 们 所 映射 的 Artist 对 
象 。 这 种 双向 关联 (bidirectional association) 非常 有 用 。 其 中 ， 需 要 将 
关联 的 一 端 标记 成 < 反 向 ”(inverse) ， 让 Hibernate 明 确 知道 究竟 在 做 什 


么 ， 这 一 点 很 重要 。 在 这 种 多 对 多 关联 的 情况 下 ， 虽 然 inverse 属 性 可 
以 影响 Hibernate 在 什么 时 候 目 动 更 新 连接 表 ， 不 过 ， 选 择 哪 一 端 作为 
反 转 映射 并 不 重要 。 如 果 只 是 从 试图 理解 数据 库 的 人 的 角度 来 考虑 ， 
既然 将 连接 数据 表 命 名 为 "TRACK_ARTISTS"， 也 就 表明 从 艺人 
(ARTISTS#) 链接 回 曲 目 (TRACK) 是 反 向 端的 最 佳 选 择 。 


Hibernate 本 号 并 不 在 意 我 们 选择 哪 一 端 ， 只 要 我 们 将 其 中 一 端 标 
识 为 inverse 就 可 以 。 我 们 在 例 4-1 中 就 是 这 样 配置 的 。 在 这 样 的 配置 
下 ， 如 果 我 们 对 Track 对 象 内 的 artists 集 合 做 出 了 修改 ，Hibernate 将 知道 
它 需要 更 新 TRACK_ARTISTS 表 。 而 如 采 我 们 对 Artist 对 象 中 的 tracks 集 
合 做 出 了 修改 ，Hibernate 不 会 自动 更 新 。 


更 新 Track 映 射 文档 时 ， 我 们 也 可 以 像 补 充 Artist 的 name 属 性 那样 ， 
来 充实 title 属 性 的 配置 : 


<property name="title"type="string" > 

<meta attribute="use-in-tostring">true</meta> 

<column name="TITLE"not -null="true"index="TRACK_TITLE"/ > 
</property> 


有 了 这 个 更 新 过 的 映射 文件 ， 我 们 可 以 再 次 重新 执行 ant codegen 来 
更 新 Track 的 源 代码 ， 并 创建 新 的 Artist 类 的 源 代 码 。 如 果 你 查看 


Track.java 文 件 ， 会 看 到 已 经 新 增加 了 一 个 类 型 为 Set 的 artists 必 性， 还 新 
增加 了 一 个 toString () 方法 。 例 4-4 是 新 的 Aristjava 的 内 容 。 


例 4-4: 为 Artist 类 生成 的 代码 


package com.oreilly.hh.data; 

//Generated Sep 3, 2007 10: 12: 45 PM by Hibernate Tools 3.2.0.b9 
import java.util.HashSet; 

import java.util.Set; 

JR 

*Represents an artist who is associated with a track or album. 
*@author Jim Elliott (with help from Hibernate) 

£7 

public class Artist implements java.io.Serializable{ 

private int id; 

private String name; 

JER 

*Tracks by this artist 

*/ 

private Set tracks=new HashSet (0) ; 

public Artist () { 

} 

public Artist (String name) { 

this .name=name; 


public Artist (String name, Set tracks) { 
this .name=name; 

this.tracks=tracks; 

} 

public int getId () { 

return this.id; 

} 

protected void setId (int id) { 
this.id=id; 


public String getName () { 
return this.name; 


public void setName (String name) { 
this .name=name; 

} 

JES 

**Tracks by this artist 

*/ 

public Set getTracks () { 

return this.tracks; 


public void setTracks (Set tracks) { 
this.tracks=tracks; 


} 

/** 

*toString 

*@return String 

*/ 

public String toString () { 

StringBuffer buffer=new StringBuffer () ; 

buffer.append (getClass () .getName () ) .append ("@") .append ( 

Integer.toHexString (hashCode () ) ) .append ("[") ; 

buffer.append ("name") .append ("='") .append (getName () ) .append 
(™ 1 ") ; 

buffer.append ("]") ; 

return buffer.toString () ; 


} 
} 


注意 : 有 人 在 给 Hibernate 挑 毛病 吗 ? 修改 一 下 代码 生成 工具 ， 在 
toString () 方法 中 使 用 StringBuilder， 而 不 是 StringBuffer， 怎 么 样 ? 


为 什么 不 能 正常 运行 


如 采 你 看 到 Hibernate 报 告 以 下 儿 行 信息 ， 移 不 要 失望 : 


[hibernatetool]An exception occurred while running exporter 

#2: hbm2java (Generates a set of.java files) 

[hibernatetool]To get the full stack trace run ant with-verbose 

[hibernatetool]org.hibernate.MappingNotFoundException: resource: 

com/oreilly/hh/data/Track.hbm.xml not found 

[hibernatetool]A resource located at 
com/oreilly/hh/data/Track.hbm.xml was not 

found. 

[hibernatetool]Check the following: 

[hibernatetool] 

[hibernatetool]1) Is the spelling/casing correct? 

[hibernatetool]2) Is com/oreilly/hh/data/Track.hbm.xml available 
via the c 

lasspath? 

[hibernatetool]3) Does it actually exist? 

BUILD FAILED 


这 只 是 因为 你 从 新 下 载 的 示例 目录 中 运行 程序 ，Ant 还 没有 准备 好 
类 路 径 (classpath) 声明 ， 我 们 以 前 在 第 2 章 的 2.3 忆 讨论 过 这 个 问题 。 
如 果 你 再 试 着 运行 一 次 (或 者 在 第 一 次 运行 之 前 ， 先 手工 运行 一 次 ant 


prepare 命 令 ) ， 束 没有 问题 了 。 


其 他 


考虑 过 现在 Javad) 提倡 的 类 型 安全 (type-safety) 的 问题 吗 ? 
目前 生成 的 这 些 类 使 用 的 都 是 Collections 类 的 非 沁 型 化 (nongeneric) 
版 本 ， 用 当前 新 版 本 的 Java 编 译 器 来 编译 这 些 代 码 时 ， 编 译 器 会 报告 类 
似 以 下 的 信息 : 

[javac]Note: /Users/jim/svn/oreilly/hib_dev_2e/current/scratch/ch 
a /src/com/oreilly/hh/CreateTest.java uses unchecked or unsafe 


operations. 
[javac]Note: Recompile with-Xlint: unchecked for details. 


如 果 有 办 法 可 以 生成 使 用 Java 泛 型 (Generics) 的 代码 ， 那 结果 一 
定 非常 棒 ， 这 样 就 可 以 加 强 对 放 入 tracks 集 合 (Set) 的 东西 的 控制 ， 同 
时 也 避免 了 这 些 编 译 警 告 ， 也 不 用 像 原 来 使 用 Collections 时 ， 需 要 进行 
棕 琐 的 类 型 转换 。 还 好 ， 非 币 泣 运 ， 只 要 修改 一 下 我 们 调用 hbm2java 
的 方式 ， 问 题 就 可 以 解决 了 。 编 辑 build.xml 文 件 ， 将 hmb2java 一 行 修改 
为 以 下 样子 : 


<hbm2java jdk5="true"/> 


这 是 在 告诉 生成 工具 ， 我 们 正在 使 用 Java 5 (或 更 高 版 本 ) 环境 ， 
这 样 承 可 以 利用 新 JDK 提 供 的 有 用 的 新 功能 了 。 经 过 这 一 修改 后 ， 再 次 
运行 ant codegen， 注 意 观 察 一 下 新 生成 的 代码 中 的 变化 ， 如 例 4-5 中 突 
出 


显示 的 部 分 所 示 。 


例 4-5: 用 jdk5 方 式 生成 Artist 类 的 改进 


public Artist (String name, Set<Track>tracks) { 


this .name=name; 
this.tracks=tracks; 


public Set<Track>getTracks () { 
return this.tracks; 


} 
public void setTracks (Set<Track>tracks) { 
this.tracks=tracks; 


Inia te 7s Be SIPS, EH Java 5 的 Collections 新 增 的 泛 型 功 


能 ， 漂 亮 地 实现 了 类 型 安全 的 集合 。 对 Track.java 中 的 artists 属 性 也 进 


类 似 的 处 理 。 这 里 先 以 新 的 Track 类 “完整 ”(fuu) 构造 函数 作为 例子 ， 
稍 后 将 在 例 4-9 中 看 到 如 何 调 用 该 构 千 函数: 


String filePath, Date playTime, 


public Track (String title, 
short volume) { 


Set<Artist>artists, Date added, 


注意 : 噢 ， 这 样 就 好 多 了 “。 这 人 么 个 不 起 眼 的 配置 参数 ， 竟 带 来 这 
公关 的 好 处 < 


在 这 个 新 的 构造 男 数 中 ， 为 playTime 和 Data added 属 性 之 间 的 artists 
属性 创建 了 一 个 参数 化 的 Set 类 型 的 参数 。 


现在 已 经 创建 (或 更 新 ) 好 了 类 ， 我 们 就 可 以 使 用 ant schema 来 建 
立 文 持 它 们 的 新 数据 库 模 式 了 。 


当然 ， 在 生成 源 代 码 和 建立 数据 库 模 式 时 应 该 注意 有 没有 出 现 错 
误 消 息 ， 以 免 映 射 文档 中 有 任何 语法 或 概念 性 错误 。 不 过 ， 并 非 所 有 
出 现 的 异常 都 是 你 必须 解决 的 实际 问题 。 我 在 试验 如 何 改 进 这 个 数据 
库 模式 时 ， 相 到 了 几 个 异常 ， 报 告 Hibernate 试 图 删除 以 前 运行 时 并 没 
有 建立 过 的 外 键 (foreign key) 约束 。 模 式 生 成 工具 并 不 予以 理会 ， 而 
继续 进行 下 去 。 这 看 起 来 很 可 怕 ， 但 却 可 以 正常 运行 。 这 一 扩 在 未 来 
版 本 中 可 能 会 有 所 改进 (Hibernate 或 HSQLDB， 或 者 也 许 只 是 修改 SQL 
方言 的 实现 ) ， 不 然 ， 也 要 学 着 忍受 这 些小 缺点 ， 它 们 已 经 存在 好 几 
年 了 。 


生成 的 数据 库 模 式 中 包含 我 们 期 竺 的 数据 库 表 ， 其 中 有 一 些 索引 
和 外 键 约 束 的 设置 。 随 着 我 们 的 对 象 模型 越 来 越 复杂 ，Hibernate 所 做 


的 工作 量 (以 及 专业 性 难度 ) 也 会 逐渐 增加 。 模 式 生成 工具 的 完整 办 
出 相当 宛 长 ， 所 以 例 4-6 仅 列 出 一 些 重点 内 容 。 


例 4-6: 摘录 目 新 生成 的 数据 库 模 式 的 部 分 内 容 


[hibernatetool]drop table ARTIST if exists; 

[hibernatetool]drop table TRACK if exists; 

[hibernatetool]drop table TRACK_ARTISTS if exists; 

[hibernatetool]create table ARTIST (ARTIST_ID integer generated 
by default 

as identity (start with 1) , NAME varchar (255) not null, 

primary key (ARTIST_ID) , unique (NAME) ) ; 

[hibernatetool]create table TRACK (TRACK_ID integer generated by 
default as 

identity (start with 1) , TITLE varchar (255) not null, 

filePath varchar (255) not null, playTime time, added date, 

volume smallint not null, primary key (TRACK_ID) ) ; 

[hibernatetool]create table TRACK_ARTISTS (ARTIST_ID integer not 
null, 

TRACK_ID integer not null, primary key (TRACK_ID, ARTIST_ID) ) ; 

[hibernatetool]create index ARTIST_NAME on ARTIST (NAME) ; 

[hibernatetool]create index TRACK_TITLE on TRACK (TITLE) ; 

[hibernatetool]alter table TRACK_ARTISTS add constraint 

FK72EFDAD8620962DF foreign key (ARTIST_ID) references ARTIST; 

[hibernatetool]alter table TRACK_ARTISTS add constraint 

FK72EFDAD82DCBFAB5 foreign key (TRACK_ID) references TRACK; 


主意 : WE! 我 甚至 还 不 知道 怎么 在 HSQLDB 中 做 这 些 事 ! 


图 4-1 是 新 增加 了 这 些 内 容 后 ， 数 据 库 模式 在 HSQLDB 中 的 树 形 视 
图 。 我 不 确信 为 什么 为 艺人 的 姓名 字段 (NAME 字 段 ) 要 用 两 个 单独 
的 索引 来 建立 惟一 性 约束 限制 ， 但 这 似乎 是 HSQLDB 本 和 喘 特殊 的 实现 
方法 ， 不 过 这 种 方式 运行 得 很 好 。 
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HE SYS_IDX_49 
} Unique: true 
—ARTST_ID 
HE SYS_IDX_SYS_CT_48_§ 
Unique: true 
| NAME 
-E ARTGT.NAME 
Unique: false 
—NAME 
TRACK 
$chema: PUBLIC 
国 TRACKID 
图 TITLE 
国 FILEPATH 
E PLAYTIME 
~ ADDED 
-E VOLUME 
Indices 
E SYS_IDX $2 
-E TRACK TITLE 
-H TRACK ARTISTS 
schema: PUBLIC 
® ARTEBT.ID 
E TRACKID 
E Indices 
HE ST5_IDX._S4 
HE ST5.IOX S56 
-E ST5.IDX._58 
-由 Properties 


图 4-1 更 新 数据 库 模 式 后 的 HSQLDB 树 状 图 形 界面 


KETTAF 


我 们 已 经 建立 了 一 个 对 象 模型 ， 让 Track 和 Artist 对 象 可 以 记录 彼此 
之 间 的 任何 一 组 关系 。 任 何 曲目 都 可 以 关联 到 任意 数目 的 艺人 ， 而 任 
何 艺 人 也 可 以 关联 任意 数目 的 曲目 。 要 将 这 种 模型 正确 地 建立 起 来 可 
能 确实 不 容易 ， 尤 其 是 对 于 面向 对 象 编程 或 关系 数据 库 的 新 手 (或 者 
二 者 都 是 新 手 ! ) ， 所 以 ， 有 Hibernate 的 帮助 真 的 很 好 。 但 是 等 一 
下 ， 等 你 看 到 用 这 样 建立 起 来 的 模型 来 处 理 数据 会 有 多 么 方便 时 ， 你 
会 确认 这 一 点 。 


值得 强调 的 是 ， 艺 人 和 曲目 之 间 的 连接 关系 并 没有 保存 在 ARTIST 
表 或 TRACK 表 目 身 内 。 因 为 二 者 之 间 是 多 对 多 关联 ， 这 意味 着 一 位 乙 
人 可 以 关联 到 多 个 曲目 ， 而 一 个 曲目 也 可 以 关联 到 多 位 艺人 ， 这 些 连 
接 关系 都 保存 在 另 一 个 名 为 TRACK_ARTISTS 的 单独 的 连接 表 中 。 这 张 
数据 库 表 中 的 每 一 条 记录 都 有 一 对 ARTIST_ ID 和 TRACK_ID， 用 于 代 
表 特 定 艺人 关联 到 特定 曲目 。 通 过 创建 和 删除 这 张 表 中 的 记录 行 ， 我 
们 就 可 以 建立 任何 需要 的 关联 模式 。 (这 就 是 为 什么 多 对 多 关系 总 是 
要 用 关系 数据 库 来 表达 的 原因 所 在 。 前 面 提 到 的 《Java Database Best 
Practices》 一 书 中 ，George Reese 对 这 种 数据 模型 有 很 好 的 介绍 。) 


记 住 这 一 点 以 后 ， 你 也 会 注意 到 生成 的 类 不 包含 任何 用 于 管理 
TRACK_ARTISTS 表 的 代码 ， 而 后 面 用 于 创建 和 链接 持久 化 Track 和 


Artist 对 象 的 示例 也 没有 。 不 需要 这 样 的 操作 ， 是 因为 Hibernate 中 特殊 
的 Collection 类 会 利用 例 4-1 和 例 4-3 中 增加 的 映射 信息 来 为 我 们 处 理 好 这 
些 细 订 。 好 了 ， 来 创建 一 些 曲目 和 艺人 对 象 吧 。 


集合 的 持久 化 


我 们 的 第 一 个 任务 就 是 改进 CreateTest 类 : 利用 数据 库 模式 中 新 增 
的 内 容 ， 创 建 一 些 艺 人 对 象 ， 并 为 它们 关联 上 一 些 曲 目 对 象 。 


应 该 怎么 做 


目 和 完 ， 在 CreateTest.java 中 增加 一 些 辅 助 方 法 ， 以 人 简化 我 们 的 任 
务 ， 如 例 4-7 所 示 (修改 和 新 增 内 容 以 粗 体 显示 ) 。 


例 4-7: 用 于 查找 和 创建 艺人 对 象 ， 并 将 它们 链接 到 曲目 对 象 的 工 
具 方 法 


package com.oreilly.hh; 

import org.hibernate.”*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; @ 

JES 

*Create more sample data, letting Hibernate persist it for us. 

*/ 

public class CreateTest{ 

[** 

*Look up an artist record given a name. 

*@param name the name of the artist desired. 

*@param create controls whether a new record should be created if 

*the specified artist is not yet in the database. 

*@param session the Hibernate session that can retrieve data 

*@return the artist with the specified name, or<code>null</code 
>if no 

*such artist exists and<code>create</code>is<code>false 
</code>. 


*@throws HibernateException if there is a problem. 

se 

public static Artist getArtist (String name, boolean create, 

Session session) @ 

{ 

Query query=session.getNamedQuery 
("com.oreilly.hh.artistByName") ; 

query.setString ("name", name) ; 

Artist found= (Artist) query.uniqueResult () ; ® 

if (found==null&&create) {0 

found=new Artist (name, new HashSet<Track> () ) ; 

session.save (found) ; 


} 


return found; 


} 

pA 

*Utility method to associate an artist with a track 

private static void addTrackArtist (Track track, Artist artist) 
{© 

track.getArtists () .add (artist) ; 

} 


和 处 理 Hibernate 经 党 使 用 的 方法 一 样 ， 这 上段 代码 相当 信 单 ， 一 目 
TR: 


@ 我 们 前 面 导 入 过 java.util.Date， 但 现在 需要 导入 整个 util 包 ， 才 能 
使 用 Collection 接 口 。 粗 体 的 “*” 束 是 为 了 突出 这 一 操 ， 不 过 浏 宽 例 子 时 
容易 忽略 它 


@ 如 采 我 们 为 同样 的 艺人 创建 多 个 曲目 的 话 ， 则 希望 可 以 重用 同 
样 的 数据 (这 就 是 使 用 Artist 对 象 ， 而 不 只 是 存储 字符 串 的 全 部 原 
Al) 。getArtist () 方法 完成 按 名 字 查 找 艺 人 的 功能 


ƏuniqueRusult () 方法 是 Query 接 口 的 一 个 方便 特色 ， 尤 其 适合 于 
以 下 情况 :我们 知道 查询 要 么 只 有 一 个 结果 ， 要 么 没有 任何 结 霖 。 这 
样 束 免 去 了 获取 结果 列表 、 检 查 列表 长 度 。 如 有 果 包 含 数据 的 话 ， 表 提 
取 第 一 个 结 东 元 率 ， 这 么 多 索 琐 的 步 又 。 使 用 这 个 方法 要 么 只 取 回 一 
MER: 或 者 当 没 有 结果 时 ， 就 返回 null 《如果 查询 返回 多 个 结果 ， 这 
个 方法 将 抛 出 一 个 异 第 。 你 可 能 会 认为 我 们 在 列 上 施加 的 unique 约 束 能 
够 防止 这 种 异常 ， 但 SQL 是 大 小 写 敏感 的 ， 而 我 们 的 查询 匹配 是 大 小 
写 不 敏感 的 。 所 以 在 创建 一 个 新 记录 之 前 ， 应 该 总 是 先 调用 getArtist 
() ， 以 确保 同名 的 艺人 是 否 已 经 存在 ) ° 


@ 所 以 我 们 需要 做 的 就 是 检查 null 值 ， 如 果 没 有 找到 相应 名 字 的 艺 
人 ， 而 且 create 标 志 也 表明 我 们 想 要 创建 艺人 对 象 时 ， 束 创建 一 个 新 的 


Artist。 


如 果 我 们 省 去 session.save () 调用 ， 那 么 所 有 艺人 Artist 对 象 将 保 
持 瞬 时 状态 。Hibernate 这 时 也 很 有 帮助 ， 如 果 我 们 试图 在 这 种 情况 下 
提交 事务 ，Hibernate 就 会 检查 到 持久 化 Track 实 例 引 用 了 瞬时 状态 的 
Artist 实 例 ， 从 而 抛 出 一 个 异常 。 你 可 以 回顾 一 下 第 3 半 对 生命 周期 的 讨 
论 ， 以 及 第 5 章 的 “生命 周期 关联 ”， 它 们 更 深入 地 探究 了 这 一 问题 。 


@addTrackArtist () 方法 差不多 简单 得 令 人 化 座 。 它 只 是 普通 的 
Java Collection 代码， 获取 属于 某 个 Track 的 艺人 对 象 集 合 (Set) ， 再 将 
指定 的 Artist 添 加 到 这 个 集合 中 。 这 样 真 可 以 实现 我 们 需要 的 所 有 功能 


吗 ? 我 们 通常 不 得 不 写 的 数据 库 处 理 代码 都 跑 到 哪儿 去 了 ? 欢迎 来 到 
对 象 /关系 映射 工具 的 精彩 世界 ! 


可 以 看 到 getArtist () 方法 内 部 使 用 一 个 命名 查询 来 检索 Artist 记 
录 。 我 们 在 Artist.hbm.xml 的 末尾 添加 了 这 个 命名 查询 的 定义 ， 如 例 4-8 


HEA 


所 示 。 (实际 上 ， 可 以 将 命名 查询 放 在 任意 映射 文件 中 ， 但 这 是 最 合 


适 的 地 方 ， 因 为 这 个 查询 和 Artist 记 录 相 关 。) 
例 4-8: 在 Artist 映 射 文档 中 添加 检索 查询 语句 


<query name="com.oreilly.hh.artistByName"> 

<! [CDATA[ 

from Artist as artist 

where upper (artist.name) =upper (: name) 

]] > 

</query> 

该 命名 查询 使 用 upper O 函数 对 艺人 的 姓名 进行 大 小 写 不 敏感 
(case-insensitive) 的 比较 ， 这 样 ， 即 使 查询 时 所 用 的 大 小 写 与 数据 库 
中 保存 的 数据 不 一 样 ， 也 可 以 检索 到 相应 的 志 人 。 这 种 不 区 分 大 小 
写 ， 但 又 能 保留 其 原 有 大 小 写 的 方法 是 一 种 用 户 友好 的 方法 ， 用 户 都 
喜欢 这 种 实现 方式 ， 所 以 值得 我 们 尽 可 能 实现 。 除 了 HSQLDB， 其 他 
数据 库 中 将 字符 串 转 换 成 大 写 的 函数 可 能 有 不 同 的 名 称 ， 但 应 该 都 
有 。 我 们 将 在 第 8 章 介绍 一 种 面向 Java 的 、 独 立 于 数据 库 的 方法 ， 以 一 


种 漂亮 的 方式 来 实现 这 种 字符 串 转换 。 


现在 ， 我 们 以 此 为 基础 来 真正 创建 一 些 链接 了 艺人 的 曲目 对 和 象 。 
例 4-9 展 示 了 CreateTest 类 的 剩余 部 分 ， 新 增 部 分 以 粗 体 字 显示 。 按 照 示 
例 所 演示 的 ， 编 辑 你 的 源 文件 (或 直接 下 载 以 节省 打字 时 间 ) 。 


例 4-9: 修改 CreateTest.java 的 main () 方法 ， 增 加 艺人 关联 数据 


public static void main (String args[]) throws Exception{ 

//Create a configuration based on the XML file we've put 

//in the standard place. 

Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 

SessionFactory sessionFactory=config.buildSessionFactory () ; 

//Ask for a session using the JDBC information we've configured 

Session session=sessionFactory.openSession () ; 

Transaction tx=null; 

try{ 

//Create some data and persist it 

tx=session.beginTransaction () ; 

Track track=new Track ("Russian Trance", 

"vyol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") , 

new HashSet<Artist> () , @ 

new Date () , (short) ©) ; 

addTrackArtist (track, getArtist ("PPK", true, session) ) ; 

session.save (track) ; 

track=new Track ("Video Killed the Radio Star", 

"yvol2/album611/track12.mp3", 

Time.valueOf ("00: 03: 49") , new HashSet<Artist> () , 

new Date () , (short) ©) ; 

addTrackArtist (track, getArtist ("The Buggles", true, 
session) ) ; 

session.save (track) ; 

track=new Track ("Gravity's Angel", 

"vol2/album175/track03.mp3", 

Time.valueOf ("00: 06: 06") , new HashSet<Artist> () , 

new Date () , (short) ©) ; 

addTrackArtist (track, getArtist ("Laurie Anderson", true, 
session) ) ; 

session.save (track) ; 

track=new Track ("Adagio for Strings (Ferry Corsten Remix) ", @ 

"yvyol2/album972/track01.mp3", 


Time.valueOf ("00: 06: 35") , new HashSet<Artist> () , 

new Date () , (short) 0) ; 

addTrackArtist (track, getArtist ("William Orbit", true, 
session) ) ; 

addTrackArtist (track, getArtist ("Ferry Corsten", true, 
session) ) ; 

addTrackArtist (track, getArtist ("Samuel Barber", true, 
session) ) ; 

session.save (track) ; 

track=new Track ("Adagio for Strings (ATB Remix) ", 

"vol2/album972/track02.mp3", 

Time.valueOf ("00: 07: 39") , new HashSet<Artist> () , 

new Date () , (short) ©) ; 

addTrackArtist (track, getArtist ("William Orbit", true, 
session) ) ; 

addTrackArtist (track, getArtist ("ATB", true, session) ) ; 

addTrackArtist (track, getArtist ("Samuel Barber", true, 
session) ) ; 

session.save (track) ; 

track=new Track ("The World'99", 

"vol2/singles/pvw99.mp3", 

Time.valueOf ("00: 07: 05") , new HashSet<Artist> () , 

new Date () , (short) ©) ; 

addTrackArtist (track, getArtist ("Pulp Victim", true, 
session) ) ; 

addTrackArtist (track, getArtist ("Ferry Corsten", true, 
session) ) ; 

session.save (track) ; 

track=new Track ("Test Tone 1", © 

"vol2/singles/test01.mp3", 

Time.valueOf ("00: 00: 10") , new HashSet<Artist> () , 

new Date () , (short) ©) ; 

session.save (track) ; 

//We're done; make our changes permanent 

tx.commit () ; 

}catch (Exception e) { 

if (tx! =null) { 

//Something went wrong; discard all partial changes 

tx.rollback () ; 

} 

throw new Exception ("Transaction failed", e) ; 

}finally{ 

//No matter what, close the session 

session.close () ; 

} 

//Clean up after ourselves 

sessionFactory.close () ; 


} 


例 4-9 对 现 有 程序 代码 的 修改 相当 有 限 : 


@ 前 面 儿 行 代码 用 于 创建 第 3 章 中 的 3 个 曲目 对 象 ， 这 里 只 需要 为 
每 个 曲目 对 象 提供 一 个 新 的 参数 来 作为 Artist 关 联 的 最 初 空 集 合 。 随 后 
每 个 再 用 一 行 代码 来 为 曲目 建立 艺人 的 关联 。 我 们 原本 可 以 用 不 同 的 
结构 来 实现 这 段 代码 ， 编 写 一 个 工具 方法 以 创建 包含 乞 人 对 象 的 最 初 
的 HashSet， 这 样 束 能 用 一 行 代码 完成 所 有 的 处 理 。 不 过 ， 对 于 多 艺人 
的 曲目 对 象 ， 我 们 实际 使 用 的 这 种 方法 的 适应 性 更 好 ， 下 一 节 将 演示 
这 种 情况 。 


@ 最 大 一 段 新 代 码 是 简单 地 添加 了 3 个 新 的 曲目 ， 以 演示 如 何 处 理 
每 个 曲目 有 多 个 关联 艺人 的 情况 。 如 果 你 喜欢 电子 首 乐 和 舞曲 (或 者 
古典 音乐 之 类 的 曲目 ) ， 就 应 该 知道 这 个 问题 多 么 重要 。 因 为 我 们 将 
链接 表达 为 集合 对 象 ， 所 以 维护 关联 束 简 化 为 将 每 个 艺人 对 和 象 汪 、 加 到 
相应 的 曲目 对 象 束 可 以 了 。 

人 最 后 ， 我 们 添加 了 一 个 没有 艺人 关联 的 曲目 对 象 ， 看 看 会 发 生 
什么 。 现 在 ， 你 可 以 运行 ant ctest 来 创建 新 的 样 例 数据 ， 其 中 包含 了 曲 
目 、 乞 人 以 及 他 们 之 间 的 关联 。 


如 有 果 需 要 对 测试 数据 创建 程序 进行 修改 ， 又 想 再 次 从 空 数 据 库 开 


台 运 行程 序 ， 一 个 有 用 的 技巧 是 执行 ant schema ctest 命 令 。 这 个 命令 是 


告诉 Ant 先 后 分 别 执行 schema 和 ctest 构 建 目 标 。 执 行 schema 构 建 目 标 会 
将 现 有 数据 全 部 清空 ， 接 着 再 执行 ctest 以 重建 数据 。 


注意 : 当然 ， 现 实生 活 中 将 数据 放 到 数据 库 会 采用 其 他 做 法 一 通 
过 用 户 界 面 或 将 实际 的 曲目 数据 直接 导入 数据 库 。 不 过 ， 如 采 只 走 单 
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运行 ctest 后 ， 除 了 Hibernate 使 用 的 SQL 语句 (如 果 仍 然 将 
hibernate.cfg.xml 中 的 show_sql 设 置 为 true) ， 没 有 什么 非常 有 意义 的 和 输 
出 。 可 以 打开 data/music.script 来 看 一 看 里 面 新 创建 了 什么 ， 或 者 用 ant 
db 命令 打开 数据 库 管 理 器 图 形 界面 来 查看 。 看 看 这 三 个 数据 库 表 的 内 
容 。 图 4-2 显 示 了 连接 表 中 代表 艺人 和 曲目 之 间 关 联 的 结果 。 原 始 数据 
已 经 隐藏 起 来 了 。 如 有 果 你 习惯 使 用 关系 数据 库 模 型 ， 则 这 样 的 查询 结 
有 果 表 示 一 切 都 运行 正常 ， 如 果 你 和 我 一 样 都 是 几 人 ， 那 么 下 一 节 介 绍 
的 内 容 将 更 加 令 人 人 信服， 当然 也 更 加 有 趣 。 


B jdbe:hsqldb:data/music 
-B ARTIST 
—schema: PUBLIC 
-E ARTST_ID 
- 国 NAME 
B Indices 
A TRACK 
schema: PUBLIC 
- 国 TRACKID 
- 国 TITLE 
-E FILEPATH 
& PLAYTIME 
- 国 ADDED 
国 YOLUME 
- 国 Indices 
-A TRACK_ARTISTS 
schema: PUBLIC 
- 国 TRACKID 
- 国 ARTET _ID 
& Indices 


——+ 
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图 4-2 新 版 CreateTest 创 建 的 艺人 和 曲目 之 间 的 关联 


集合 的 检索 


你 可 能 会 认为 从 数据 库 中 把 集合 信息 检索 出 来 同样 也 是 这 么 简 
单 。 没 错 ! 这 一 市 将 改进 一 下 我 们 的 QueryTest 类 ， 把 艺人 及 相关 的 曲 
目 显 示 出 来 。 例 4-10 以 粗 体 字 展 示 了 适当 的 修改 和 增加 的 代码 。 而 且 
只 需要 新 增 少量 的 代码 。 


例 4-10: 改进 的 QueryTest.java (以 便 显示 关联 了 曲目 的 艺人 对 
象 ) 


package com.oreilly.hh; 

import org.hibernate. * 

import org.hibernate.cfg.Configuration; 
import com.oreilly.hh.data. * 

import java.sql.Time; 

import java.util.*; 


*Retrieve data as objects 

*/ 

public class QueryTest{ 

JER 

*Retrieve any tracks that fit in the specified amount of time. 

* 

*@param length the maximum playing time for tracks to be 
returned. 

*@param session the Hibernate session that can retrieve data. 

*@return a list of{@link Track}s meeting the length restriction. 

27 

public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery ( 

"com.oreilly.hh.tracksNoLongerThan") ; 

query.setTime ("length", length) ; 

return query.list () ; 


J 


JEZ 

*Build a parenthetical, comma-separated list of artist names. 

*@param artists the artists whose names are to be displayed. 

*@return the formatted list, or an empty string if the set was 
empty. 

*/ 

public static String listArtistNames (Set<Artist>artists) {0 

StringBuilder result=new StringBuilder () ; 

for (Artist artist: artists) { 

result.append ( (result.length () ==0) 2?" (": ", ") ; 

result.append (artist.getName () ) ; 


} 

if (result.length ( >0) { 
result.append (") ") ; 

} 


return result.toString () ; 

} 

JER 

*Look up and print some tracks when invoked from the command 
line. 

*/ 

public static void main (String args[]) throws Exception{ 

//Create a configuration based on the XML file we've put 

//in the standard place. 

Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 

SessionFactory sessionFactory=config.buildSessionFactory () ; 

//Ask for a session using the JDBC information we've configured 

Session session=sessionFactory.openSession () ; 

try{ 

//Print the tracks that will fit in seven minutes 

List tracks=tracksNoLongerThan (Time.valueOf ("00: 07: 00") , @ 

session) ; 

for (ListIterator iter=tracks.listIterator () ; 

iter.hasNext () ; ) { 

Track aTrack= (Track) iter.next () ; 

System.out.println ("Track: \""+aTrack.getTitle () +"\""+ 

listArtistNames (aTrack.getArtists () ) +6 

aTrack.getPlayTime () ) ; 

} 

}finally{ 

//No matter what, close the session 

session.close () ; 

} 

//Clean up after ourselves 

sessionFactory.close () ; 


} 


@ 我 们 增加 的 第 一 个 方法 是 一 个 小 工具 方法 ， 用 于 谭 亮 地 格式 化 
一 组 亏 人 的 名 字 ， 将 乞 人 名 字 放 在 一 对 圆 括号 内 ， 并 用 喜 号 “，? 作 为 
隅 符 ， 再 加 上 适当 的 空格 。 或 者 如 采 亏 人 集合 为 空 的 话 ， 束 什么 也 


I7 
不 显示 


@ 对 于 新 加 的 所 有 有 趣 的 多 乙 人 相关 的 曲目 ， 其 播放 时 间 都 超过 5 
分 钟 ， 所 以 我 们 将 查询 限 值 增加 a 到 7 分 钟 ， 这 样 才能 看 到 结 


日 最 后 ， 我 们 在 printtn () 语句 的 适当 位 置 上 调用 listArtistNames 

O 方法 ， 描 述 找到 的 曲目 信息 。 现 在 先 去 掉 Hibernate 的 查询 调试 输 

出 配置 ， 因 为 这 些 调 试 信息 会 妨碍 我 们 观察 真正 想 要 看 到 的 信息 。 编 
辑 src 目 录 下 的 hibernate.cfg.xml 文 件 ， 将 show_sql 属 性 修改 为 false。 


<! --Echo all executed SQL to stdout--> 
<property name="show_sql">false</property> 


这 样 设置 以 后 ， 例 4-11 演 示 了 执行 ant qtest 命 令 后 ， 新 的 输出 结 
果 。 


例 4-11: QueryTest 输 出 的 世人 信息 


%ant qtest 
Buildfile: build.xml 
prepare: 


compile: 

[javac]Compiling 1 source file 
to/Users/jim/svn/oreilly/hib_dev_2e 

/current/scratch/ch04/classes 

qtest: 

[java]Track: "Russian Trance" (PPK) 00: 03: 30 

[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 

William Orbit, Samuel Barber) 00: 06: 35 

[java]Track: "Test Tone 1"00: 00: 10 

BUILD SUCCESSFUL 

Total time: 2 seconds 


你 会 注意 到 两 件 事 。 首 先 ， 可 以 看 到 这 种 结果 显示 方式 比 图 4-2 中 
简单 的 数字 列表 更 容易 解读 。 其 次 ， 运 行 无 疙 ! BNE Nar Ela ZAR 
出 数 据 、 纯 测试 用 的 “特殊 ”曲目 都 没有 问题 ， 因 为 Hibernate 采 用 的 方 
法 比较 友好 ， 在 这 种 特殊 情况 下 会 创建 一 个 不 含 艺 人 对 和 象 的 空 Set 对 
象 。 免 去 了 我 们 为 防止 引发 NullPointerException ( 空 指针 错误 ) 异 
常 ， 而 自己 编写 代码 检测 对 象 是 否 为 null 的 需 


注意 : 但是， 等 一 下 ， 还 有 呢 ! 不 需要 编写 额外 的 代码 .…… 


合用 双 癌 天 联 


在 新 建 数据 的 代码 中 ， 我 们 简单 地 通过 把 Java 对 象 添加 到 适当 的 集 
合 ， 就 建立 起 曲目 对 象 到 艺人 对 象 的 链接 。Hibernate 会 把 这 些 关 联 和 
对 象 分 组 转化 成 它 为 此 所 创建 的 连接 表 中 必要 的 隐 舍 项 。 这 样 ， 我 们 
就 能 用 简单 易 读 的 代码 来 建立 和 维护 这 些 关 联 关系 。 但 是 要 记 住 ， 我 
们 在 这 里 创建 的 这 个 关联 是 双向 的 ，Artist 类 中 也 有 一 个 内 含 一 些 Track 
对 象 集合 的 关联 。 不 用 烦恼 应 该 在 那 存 储 什么 。 


这 种 设计 的 方便 性 在 于 ， 只 有 当 对 “主要 映射 ”(primary mapping) 
做 出 修改 时 ， 才 会 对 修改 传播 到 反 回 映射 病 。 如 有 果 只 对 反 回 映射 病 做 
出 修改 〈 就 此 例 而 言 ， 就 是 修改 Artist 对 象 中 保存 曲目 的 Set 集 合 对 
象 ) ， 那 么 修改 结果 不 会 保存 下 来 。 可 惜 ， 这 就 要 求 你 在 代码 中 要 注 
意 哪 个 映射 是 反 向 映射 端 。 


好 消 明 是 我 们 不 用 为 此 而 必须 做 些 什 么 。 因 为 我 们 在 Artist 映 射 文 
档 中 将 这 个 关联 标识 为 反 向 映射 (inverse="true") ，Hibernate 知 道 当 为 
一 个 Track 对 象 新 增 一 个 Artist 关 联 时 ， 另 一 层 没 说 的 话 就 是 也 把 该 Track 
作为 关联 而 添加 给 了 那个 Artist 。 


我 们 来 构建 一 个 简单 的 交互 式 图 形 应 用 程序 ， 以 帮助 检查 乞 人 对 
曲目 的 关联 链接 是 否 正 确 。 这 个 应 用 程序 可 以 让 你 输入 艺人 的 姓名 ， 


然后 显 出 与 该 艺人 相关 联 的 曲目 。 大 部 分 代码 和 第 一 个 查询 测试 程序 
非常 类 似 。 现 在 ， 创 建 QueryTest2.java 文 件 ， 并 输入 例 4-12 所 示 的 程序 
代码 。 


例 4-12: QueryTest2.java 的 源 代 码 


package com.oreilly.hh; 

import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; import java.awt.*; 

import java.awt.event.*; 

import javax.swing.*; 

/** 

*Provide a user interface to enter artist names and see their 
tracks. 

bd 

public class QueryTest2 extends JPanel{ 

JList list; //will contain tracks associated with current artist 

DefaultListModel model; //Lets us manipulate the list contents 

fet 

*Build the panel containing UI elements 

*/ 

public QueryTest2 () { 

setLayout (new BorderLayout () ) ; 

model=new DefaultListModel () ; 

list=new JList (model) ; 

add (new JScrollPane (list) , BorderLayout.SOUTH) ; 

final JTextField artistField=new JTextField (28) ; 

artistField.addKeyListener (new KeyAdapter () {0 

public void keyTyped (KeyEvent e) {@ 

SwingUtilities.invokeLater (new Runnable () {® 

public void run () { 

updateTracks (artistField.getText () ) ; 


} 

P; 

} 

P; 

add (artistField, BorderLayout.EAST) ; 

add (new JLabel ("Artist: ") , BorderLayout.WEST) ; 


} 


JER 

*Update the list to contain the tracks associated with an artist 
tf 

private void updateTracks (String name) {0 
model.removeAllElements () ; //Clear out previous tracks 

if (name.length () <1) return; //Nothing to do 

try{ 

//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; © 

try{ 

Artist artist=CreateTest.getArtist (name, false, session) ; 

if (artist==null) {//Unknown artist 

model.addElement ("Artist not found") ; 

return; 

} 

//List the tracks associated with the artist 

for (Track aTrack: artist.getTracks () ) {0 

model.addElement ("Track: \""+aTrack.getTitle () + 

"\", "+aTrack.getPlayTime () ) ; 


} 

}finally{@ 

//No matter what, close the session 

session.close () ; 

} 

}catch (Exception e) { 

System.err.printin ("Problem updating tracks: "+e) ; 
e.printStackTrace () ; 


} 
} 


private static SessionFactory sessionFactory; //Used to talk to 
Hibernate 

fer 

*Set up Hibernate, then build and display the user interface. 

*/ 

public static void main (String args[]) throws Exception{ 

//Load configuration properties, read mappings for persistent 
classes 

Configuration config=new Configuration () ; © 

config.configure () ; 

//Get the session factory we can use for persistence 

sessionFactory=config.buildSessionFactory () ; 

//Set up the UI 

JFrame frame=new JFrame ("Artist Track Lookup") ; © 

frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE) ; 

frame.setContentPane (new QueryTest2 () ) 

frame.setSize (400, 180) ; 

frame.setVisible (true) ; 


} 


注意 : 没 错 ， 这 是 露骨 的 推销 。 


示例 中 有 一 大 段 靳 增加 的 代码 用 于 建立 一 个 Swing 用 户 界面 ， 这 实 
际 上 还 是 个 相当 原始 的 界面 ， 无 法 漂亮 地 调整 窗口 大 小 。 但 是 ， 如 果 
要 处 理 这 些 界面 效果 上 的 细节 ， 程 序 会 变 得 更 长 ， 其 实 这 些 内 容 也 不 
是 本 书 应 该 讨论 的 范围 。 如 果 你 想 看 一 些 如 何 建立 丰富 、 高 质量 的 
Swing 界 面 的 例子 ， 可 以 参考 Kava Swing) (O'Reilly, Second 
Edition) ， 这 是 一 本 很 厚 的 巨著 ， 介 绍 了 Swing 界面 开发 的 方方面面 。 


@@ 在 构造 函数 中 我 想 重点 介绍 的 只 有 KeyListener， 要 将 它 加 到 
artistField。 这 段 代 码 相 当 有 技巧 ， 它 创建 了 一 个 匿名 (anonymou) 
类 ， 无 论 用 户 何 时 在 忆 人 文本 框 中 输入 信息 ， 都 会 调用 这 个 匿名 类 的 
keyTyped () 方法 。 


@ 这 个 方法 检查 输入 文本 框 当前 是 否 包含 一 个 可 识别 的 艺人 名 
字 ， 并 更 新 相应 的 曲目 显示 。 


四 不 幸 的 是 ， 在 调用 这 个 方法 时 ， 还 没有 更 新 文本 框 以 反映 最 新 
的 键盘 输入 ， 所 以 我 们 不 得 不 通过 SwingUtilities 的 invokeLater () 方法 
将 实际 的 显示 更 新 推迟 到 另 一 个 匿名 类 (Runnable 的 实例 ) 中 。 这 种 技 
巧 可 以 在 Swing“ 有 时 间 处 理 来 处 理 * 时 ， 再 进行 更 新 。 在 我 们 这 个 例子 
中 意味 着 文本 输入 框 将 自己 完成 更 新 。 


@ 在 用 户 输入 艺人 名 字 时 调用 的 updateTracks () 方法 正 是 有 趣 的 
Hibernate 处 理发 生 的 地 方 。 自 完 ， 这 个 方法 清理 干净 列表 ， 也 就 是 清 
除 之 前 显示 过 的 任何 曲目 。 如 果 艺 人 名 字 为 衬 ， 束 做 到 这 里 为 止 。 


@ 否 则 ， 这 个 方法 会 打开 一 个 Hibernate 会 话 ， 试 着 用 我 们 在 
CreateTest 里 所 写 的 getArtist () 方法 查找 艺人 信息 。 这 一 次 我 们 告诉 这 
个 方法 ， 如 果 找 不 到 相应 的 和 艺人， 就 不 要 创建 和 艺人 对 象 ， 所 以 如 果 用 
尸 没 有 输入 已 知 艺 人 的 名 子 ， 束 会 得 到 一 个 null 。 


@ 帮 一 方面 ， 如 果 确 实 找到 一 个 Artist 记 录 ， 则 遍历 该 艺人 的 所 有 
天 联 曲 目 集 合 中 找到 的 Track 记 好， 并 显示 每 个 曲目 的 相关 信息 。 这 将 
测试 逆向 (inverse) 关联 是 否 按 照 我 们 的 预想 来 工作 。 


@ 最 后 〈 这 里 不 是 故意 用 双关 语 ) ， 要 确保 退出 该 方法 时 关闭 了 
会 话 ， 即 使 征 因 为 异种 而 退出 。 你 肯定 不 会 希望 发 生 会 话 泄露 ， 不 
过 ， 如 有 果 你 想 搞 震 整个 数据 库 环 境 的 话 ， 这 就 是 个 好 方法 。 


Omain () 方法 的 开始 还 是 相同 的 Hibernate 配 置 步 又 ， 我 们 以 前 就 
看 过 了 。 


人 接着， 会 创建 并 显示 用 户 界 面 框架 ， 再 设置 当 关 闭 用 户 界 面 时 
束 结 束 程序 。 显 示 这 个 界面 框架 后 ，main () REL, MABE, LEH 
Swing 事 件 循 环 控 制 后 续 流程 。 


在 创建 《或 下 载 ) 好 代码 文件 以 后 ， 还 需要 在 build.xml (Ant 构 建 
文件 ) 的 末尾 新 增加 一 个 构建 目标 (如 例 4-13 所 示 ) ， 才 能 够 调用 这 个 
新 创建 的 类 。 


注意 : 这 非常 类 似 于 现 有 的 qtest 构 建 日 标 ， 直 接 复制 、 调 整 一 下 
束 可 以 了 。 


例 4-13: 运行 新 的 查询 测试 程序 的 Ant 构 建 日 标 


<target name="qtest2"description="Run a simple Artist 
exploration GUI" 

depends="compile" > 

<java classname="com.oreilly.hh.QueryTest2"fork="true" > 

<classpath refid="project.class.path"/> 

</java> 

</target> 


现在 ， 你 可 以 输入 ant qtest2 命 令 来 启动 程序 ， 自 己 体验 一 下 这 个 程 
序 。 图 4-3 是 运行 中 的 程序 界面 ， 显 示 了 示例 数据 中 一 位 艺人 的 曲目 数 
据 。 


Track: “Adagio for Strings (Ferry Corsten Remix)", 00:06:35 
Track: “The World '99", 00:07:05 


图 4-3 非常 简单 的 艺人 曲目 浏览 锅 


使 用 简单 集合 


到 目前 为 止 ， 我 们 所 看 到 的 集合 都 含有 和 其 他 对 象 之 间 的 关联 数 
据 ， 对 于 本 章 讨 论 的 “集合 和 关联 ”这 一 主题 来 说 ， 这 并 没有 什么 不 
Z, 但 这 并 不 是 Hibernate 集 合 的 惟一 用 法 。 你 也 可 以 为 简单 值 的 集合 
ERIT, UFER ` NF ARIER AIHER o 


应 该 怎么 做 


假设 我 们 想 为 数据 库 中 的 每 个 曲目 都 保存 一 定数 量 的 评论 ， 用 一 
个 名 为 comments 的 新 属性 来 记录 每 一 个 相关 联 评论 的 String 值 。 
Track.hbm.xml 中 的 新 映 冉 数据 看 起 来 很 像 原 来 我 们 为 世人 映 味 文档 所 
做 的 那样 ， 只 是 这 里 更 为 简单 (M) 一 些 : 


<set name="comments"table="TRACK_COMMENTS" > 
<key column="TRACK_ID"/> 

<element column="COMMENT"type="String"/ > 
</set> 


(可 以 将 这 段 配置 信息 放 在 映射 文件 中 </class> 关 闭 标 签 之 前 。 
如 有 果 你 想 在 Track 类 的 构造 钞 数 中 进行 处 理 ， 也 必须 这 么 做 。) 


由 于 我 们 需要 为 每 个 Track 都 保存 任意 数量 的 评论 ， 所 以 我 们 得 另 
建 一 个 专门 用 于 保存 评论 的 新 数据 库 表 。 每 个 评论 都 会 通过 每 个 曲目 


的 id 属性 链接 到 正确 的 Track 对 象 。 


Hant schema 命 令 重新 构建 数据 库 ， 以 下 显示 了 构建 过 程 的 内 容 : 


[hibernatetool]create table TRACK_COMMENTS (TRACK_ID integer not 
null, COMMENT 

varchar (255) ) ; 

[hibernatetool]16: 16: 55, 876 DEBUG SchemaExport: 303-alter 
table TRACK_COMMENTS 

add constraint FK105B26882DCBFAB5 foreign key (TRACK_ID) 
references TRACK; 


注意 : BOERS — BAR RAMA OM BRR °° 


用 ant codegen € tTrack#:Z Ja, Wie 227ECreateTest java PY 
用 构造 函数 时 ， 为 comments 属 性 增加 另 一 个 Sat 对象 。 例 如 : 


track=new Track ("Test Tone 1", 
"vol2/singles/test01.mp3", 

Time.valueOf ("00: 00: 10") , new HashSet<Artist> () 
new Date () , (short) 0, new HashSet<String> () ) ; 


然后 ， 我 们 可 以 用 以 下 代码 行 来 指定 评论 内 容 : 


track.getComments () .add ("Pink noise to test equalization") ; 


执行 ant ctest 可 以 快速 编译 并 运行 这 个 程序 HARARE I ABE 
曲目 对 象 狐 增加 第 二 个 专门 保存 字符 串 的 HashSet 对 象 ， 接 着 再 检查 
data/music.script， 看 看 数据 库 是 如 何 存储 评论 数据 的 。 或 者 ， 在 


QueryTest.java 中 输出 曲目 信息 的 println () 之 后 再 多 加 一 个 循环 ， 以 
打印 输出 刚刚 显示 过 的 曲目 的 评论 信息 : 


for (String comment: aTrack.getComments () ) { 


System.out.printlin ("Comment: "+comment) ; 


接着 ， 运 行 ant qtest， 可 以 得 到 以 下 的 输出 : 


[java]Track: "Test Tone 1"00: 00: 10 
[java]Comment: Pink noise to test equalization 


当 工 具 让 简单 的 事 1 
看 到 ， 即 使 征 复 杂 的 事 人 


lst 


变 得 更 容易 时 ， 那 真 的 很 好 。 下 一 章 我 们 会 
， 也 十 畅通 无 阻 。 


lst 


[1] 如 果 要 将 这 些 示例 移植 到 Oracle 中 ， 必 须 修改 "COMMENT" 字 上 段 的 
名 称 ， 因 为 这 是 Oracle SQL 的 一 个 保留 字 。 还 有 很 多 类 似 的 标准 保留 


=| 


第 5 章 ”更 复杂 的 关联 


当然 啦 ， 多 个 朋友 多 条 路 。 但 是 这 并 不 簿 单 ， 所 以 应 该 探讨 一 下 
对 象 之 间 更 丰富 的 关系 ， 如 何 比 简单 的 分 组 携 珊 更 多 的 信息 。 在 本 草 
中 ， 我 们 将 要 探讨 一 下 如 何 将 曲目 组 合成 专辑 (album) 。 第 4 章 没 有 
介绍 这 一 总 ， 征 因为 组 织 专 辑 不 仅仅 是 简单 地 对 曲目 进行 分 组 ， 还 需 
要 知道 曲目 在 专辑 中 的 排列 顺序 ， 以 及 诸如 它们 在 哪 张 唱片 (disc) 
等 信息 ， 才 能 文 持 多 唱片 的 专辑 。 实 现 这 些 功能 光 靠 目 动 生 成 的 连接 
数据 库 表 十 不 够 的 ， 所 以 我 们 得 目 己 设计 AlbumTrack 对 象 和 数据 表 ， 
才 可 以 把 专辑 和 曲目 链接 起 来 。 


天 联 的 主动 加 载 和 延迟 加 载 


先 富 (rich) ， 而 后 主动 (eager) 和 延迟 (lazy) ? 这 些 词 听 起 来 
好 像 我 们 在 把 数据 模型 当成 鲜 活 的 人 物 来 介绍 。 但 这 其 实 是 O/R 映 射 
的 重要 主题 之 一 。 随 着 数据 模型 不 断 地 增长 ， 对 象 和 数据 库 表 之 间 的 
关联 也 会 随 之 增加 ， 程 序 的 功能 也 不 断 增 多 ， 这 很 好 。 但 是 ， 通 常 最 
后 的 结果 就 是 成 堆 的 对 象 之 间 被 链接 得 零 零 碎 碎 。 这 样 ， 当 从 一 大 串 
彼此 相关 的 对 象 复 中 加 载 一 个 从 属 的 对 象 时 ， 会 发 生 什 么 ? 可 以 看 
到 ， 只 要 通过 遍历 对 象 的 属性 ， 就 可 以 从 一 个 对 象 访问 到 关联 的 另 一 
个 对 象 。 这 似乎 是 说 ， 当 需要 加 载 某 个 对 象 时 ， 就 得 必须 加 载 相关 联 


的 所 有 对 象 。 对 于 小 型 数据 库 来 说 ， 这 没有 什么 问题 (事实 上 ， 我 们 
在 示例 中 使 用 的 HSQLDB 数 据 库 只 是 在 运行 时 ， 才 全 部 存在 于 内 存 
H) ; 但 是 一 般 情 况 下 ， 应 用 程序 预定 的 数据 库容 量 肯 定 要 超过 程序 
目 身 占用 的 内 存量 。 哇 ! 但 是 ， 即 使 真能 全 部 加 载 ， 也 不 太 可 能 真正 
用 到 大 部 分 数据 对 象 ， 所 以 ， 加 载 全 部 对 象 只 是 浪费 资源 而 已 。 


所 笠 ， 对 象 /关系 映射 软件 (包括 Hibernate 在 内 ) 的 设计 者 已 经 预 
见 了 这 个 问题 。 处 理 的 技巧 就 是 关联 配置 成 "lazy" 的 ， 这 样 ， 只 有 在 实 
际 需 要 访问 相关 联 对 象 的 引用 时 ， 才 会 加 载 相应 的 对 象 。Hibernate 将 
人 负责 维护 链接 对 象 的 标识 ， 直 到 真正 访问 它 时 ， 才 会 加 载 这 个 对 象 。 
这 年 我 们 经 利 使 用 的 集合 在 本 质 上 的 一 个 重要 特性 。 


应 该 怎么 做 


在 Hibernate 3 发 布 以 前 ， 关 联 在 默认 情况 下 并 不 设置 lazy 属 性 ， 所 
以 必须 手工 在 映射 声明 中 设置 lazy 属 性 。 不 过 ， 因 为 使 用 延迟 加 载 总 
是 最 佳 实 践 ， 所 以 Hibernate 3 就 默认 保留 了 lazy 的 设置 (进行 应 用 程序 
移植 时 需要 特别 小 心 ， 绝 不 要 发 生 像 这 种 癌 后 不 兼容 (backward- 


incompatible) 的 问题 ) ° 


当 对 象 的 关联 是 lazy 类 型 时 ，Hibernate 就 使 用 它 自 己 特殊 的 
Collections 类 的 延迟 加 载 实现 机 制 ， 直 到 试图 真正 使 用 集合 的 内 容 


时 ， 才 从 数据 库 中 加 载 相应 的 内 容 。 这 些 处 理 是 完全 透明 的 ， 所 以 代 
码 编写 者 并 不 会 注意 到 代码 背后 发 生 的 这 些 细节 。 


虽 ， 如 果真 是 这 么 简单 就 能 解决 加 载 大 量 相关 对 象 的 问题 ， 那 为 
什么 还 要 将 这 个 设置 关 掉 呢 ? 问题 在 于 ， 当 你 关 掉 Hibernate 会 话 时 ， 
这 种 透明 性 就 消失 了 。 在 关 掉 会 话 后 ， 如 果 你 试图 访问 尚未 初始 化 的 
延迟 加 载 集 合 (即使 将 这 个 集合 赋值 给 不 同 的 变量 ， 或 者 作为 方法 调 
用 的 返回 值 ) ，Hibernate 提 供 的 代理 集合 (proxy collection) 也 将 不 再 
访问 数据 库 以 延迟 加 载 它 的 内 容 ， 而 是 强制 抛 出 一 个 
LazyInitializationException 异 常 ( 稍 后 我 们 将 介绍 如 果 确 实 需要 很 快 关 
闭会 话 时 ， 应 该 如 何 处 理 ) 。 


注意 : 复杂 度 守 恒 看 起 来 很 像 热 力学 定律 。 


因为 这 种 无 法 预料 的 异常 与 Hibernate 特 定 的 程序 代码 本 身 没有 什 
么 关系， 与 加 载 超过 实际 使 用 数量 的 对 象 而 付出 的 潜在 代价 相 比 ， 如 
果 你 认为 加 载 所 有 可 能 需要 使 用 的 对 象 更 为 重要 ， 那 么 束 可 以 关 挥 
lazy 设 置 。 你 要 人 负责 仔细 考虑 在 什么 情况 下 需要 禁用 这 一 设置 ， 如 采 
使 用 lazy 设 置 的 话 ， 也 要 确 你 安全 地 使 用 延迟 加 载 对 象 。Hibernate 参 
著 手 册 中 深入 讨论 了 这 方面 的 选择 策略 。 


GION, MARE ME RR eee, Wn DAE ARC 
件 按 例 5-1 所 示 的 方式 进行 设置 。 


例 5-1: 在 曲目 艺人 关联 中 使 用 主动 加 载 初始 化 


<set name="artists"table="TRACK_ARTISTS"lazy="false" > 

<key column="TRACK"/ > 

<many - to-many 
class="com.oreilly.hh.data.Artist"column="ARTIST_ID"/> 

</set> 


其 他 


集合 以 外 延迟 加 载 的 用 法 ? 缓存 (cache) 和 集群 (cluster) ° 


延迟 加 载 集合 的 文 持 机 制 很 容易 理解 ， 因 为 Hibernate 提 供 了 它 目 
己 对 Collection 接 口 的 实现 。 


但 是 ， 对 于 其 他 类 型 的 关联 应 该 如 何 处 理 ? 其 他 类 型 的 关联 也 可 
以 受益 于 按 需 加 载 而 带 来 的 好 处 。 


事实 上 ，Hibernate 确 实 支 持 ， 用 法 几乎 也 是 那么 简单 《至 少 从 服 
务 的 使 用 者 来 看 确实 如 此 ) 。 同 样 ， 从 Hibernate 3 开始 ， 类 的 默认 加 
载 方式 瓯 是 延 玉 加载， 不过， 你 可 以 将 整个 持久 化 类 设置 为 
lazy="false" 来 关闭 延迟 加 载 《这 个 属性 就 放 在 映射 文档 的 class 标 签 
i 


当 采 用 延迟 加 载 的 方式 来 映射 一 个 类 时 ，Hibernate 将 生成 一 个 代 
理 类 来 扩展 数据 类 (data class) 。 这 个 延迟 代理 类 会 推迟 加 载 数据 的 


时 机 ， 直 到 真正 需要 使 用 数据 时 再 加 载 。 任 何 关 联 到 这 个 延迟 加 载 类 
的 其 他 对 象 都 会 悄悄 地 用 这 样 的 代理 对 象 进行 扩展 ， 而 不 是 引用 实际 
的 数据 对 象 。 当 第 一 次 使 用 代理 对 和 象 的 任何 方法 时 ， 才 会 加 载 真正 的 
数据 对 象 ， 并 将 方法 调用 委托 给 数据 对 象 。 在 加 载 完 成 数据 对 象 以 
后 ， 代 理 对 象 将 一 直 把 所 有 的 方法 调用 都 委托 给 它 。 如 有 果 想 做 的 再 花 
哨 点 ， 可 以 使 用 proxy 属 性 来 指定 代理 类 将 要 扩展 (或 实现 ) 的 特定 类 
(或 接口 ) 。lazy 属 性 是 将 持久 化 类 本 身 指定 为 要 被 代理 的 类 的 快捷 
方式 。 (如 采 看 不 懂 ， 也 别 担心 ， 这 只 是 说 明 你 现在 还 不 需要 这 种 功 
PEME ° mRNT, MRT! ) 


目 然 地 ， 在 会 话 关闭 之 前 才能 加 载 需 要 使 用 的 任何 东西 ， 这 一 限 
制 依然 适用 于 这 种 延迟 加 载 类 的 初始 化 。 你 可 以 使 用 延迟 加 载 类 ,但 
这 样 做 时 ， 一 定 要 小 心 慎 重 ， 并 做 好 规划 。 


Hibernate 参 考 文档 在 它 的 “提升 性 能 ”(Improving Performance) ( 
L) 一 章 中 深入 讨论 了 这 些 值得 权衡 的 考虑 。 也 介绍 了 Hibernate 甚 至 
可 以 和 JVM 层 或 集群 对 象 缓存 进行 集成 ， 以 减轻 数据 库 访 问 的 瓶颈 ， 
提升 大 型 分 布 式 应 用 程序 的 性 能 。 当 集成 这 样 的 缓存 机 制 时 ， 可 以 在 
映射 文档 中 用 cache 标 签 (足够 恰当 ) 来 配置 类 和 关联 的 缓存 行为 。 这 
些 配 置 方 法 不 在 本 书 讨 论 的 范围 内 ， 但 是 你 应 该 注意 到 这 些 可 行 的 方 
法 ， 因 为 说 不 定 你 的 应 用 程序 就 可 以 从 中 受益 。 


令 人 头痛 的 问题 


忽略 对 这 些 主 题 的 讨论 ， 可 能 不 是 你 欣赏 的 做 法 。 坦 日 地 说 ， 理 
解 代码 执行 时 的 任何 路 径 上 需要 访问 的 对 象 集 的 边界 ， 在 优化 加 载 对 
象 的 同时 ， 还 不 会 痕 费 太 多 的 内 存 和 开发 人 员 的 精力 ， 这 些 问题 都 钙 
O/R 映 射 中 存在 的 最 困难 的 权衡 和 挑战 。 甚 至 像 Hibernate 这 样 优秀 的 
组 件 库 也 不 完全 屏蔽 这 些 问题 。 


幸好 ， 有 些 技术 可 以 用 于 对 数据 访问 代码 进行 优化 ， 在 许多 常见 
的 应 用 场合 中 从 根本 上 避免 整个 问题 ， 从 中 你 可 以 理解 这 些 技 术 得 以 
流行 的 原因 。 请 记 住 ， 只 有 在 关闭 Hibernate 会 话 之 后 再 去 访问 关联 对 
象 时 ， 延 迟 加 载 的 关联 才 会 出 问题 。 如 果 在 会 话 打开 期 间 可 以 完成 所 
有 的 数据 处 理 ， 那 么 延迟 加 载 的 关联 总 是 可 以 正常 工作 ， 不 必 为 它们 


过 多 担心 。 


好 ， 那 么 在 程序 开始 运行 时 束 打 开会 话 ， 直 到 程序 结束 再 关闭 会 
话 ， 这 样 可 以 吗 ? R, 不， 这 样 是 不 行 的 。 因 为 一 个 会 话 就 包括 了 一 
个 数据 库 事务 (transaction) ， 而 数据 库 是 共享 资源 。 打 开 的 事务 被 保 
留 的 时 间 越 长 ， 数 据 库 融 越 可 能 陷入 困境 ;加 其 他 用 户 和 进程 隐藏 的 
活动 越 多 ， 这 些 活动 就 越 可 能 被 发 现 ， 当 你 最 终 提交 事务 处 理 时 ， 也 
束 越 可 能 与 其 他 事务 遇 到 冲突 。 所 以 ， 绝 对 不 要 在 等 等 用 户 进 行 操作 
的 同时 而 保持 打开 一 个 事务 。 


所 以 我 们 则 不 就 是 遇 上 Catch-22 (2) 了 ? 其 实情 况 并 没有 想象 
中 的 那么 坏 。 通 第 ， 只 要 应 用 程序 的 总 体 结构 设计 得 合理 ， 丈 可 以 让 
数据 访问 发 生 的 位 置 一 目 了 然 ， 也 束 为 Hibernate 会 话 提供 了 开始 和 结 
束 的 目 然 边界 。 例 如 对 于 Web 应 用 程序 ， 在 处 理 到 来 的 请 求 的 过 程 中 
打开 Hibernate 会 话 ， 这 样 做 很 有 和 意义。 事实 上 ， 开 发 人 员 经 第 建立 一 
些 Servlet 过 滤器 (filter) 来 自动 完成 这 些 处 理 。 此 外 ， 如 果 有 些 后 台 
任务 需要 定期 地 处 理 数据 (例如 在 夜间 发 送 电 子 邮 件 ) ， 它 们 就 可 以 
在 类 似 民 好 定义 的 边界 内 使 用 各 目 单 独 的 会 话 。 所 以 ， 虽然 处 理 策略 
需要 一 定 的 技巧 而 且 也 很 重要 ， 但 困难 也 不 是 不 能 克服 的 。 我 们 将 在 
第 13 草 和 第 14 草 用 一 些 具体 的 示例 来 演示 一 些 不 错 的 方法 。 


[1] 

http://www. hibernate.org/hib_docs/v3/reference/en/html/performance. html. 
[2] 这 个 词语 源 于 美国 著名 作家 约瑟夫 海 勒 的 成 名 作 《 第 22 条 军 规 》 
(Catch-22) ， 写 于 1961 年 ， 这 是 一 部 典型 的 黑色 幽默 之 作 。 在 当代 
英语 中 Catch-22 作 为 一 个 独立 的 单词 ， 使 用 频率 非常 高 ， 用 来 形容 自 
相 矛 盾 、 不 合 逻 辑 的 规定 ， 或 条 件 所 造成 的 无 法 脱身 或 左右 为 难 的 困 
境 。 


集合 排序 似乎 与 对 象 生命 周期 这 一 主题 有 些 偏离 ， 不 过 它 确 实 是 
一 个 重要 内 容 。 这 一 章 本 来 束 打 算 介 绍 一 些 处 理 集合 映射 方面 的 有 趣 
的 技巧 ， 所 以 我 们 就 言 归 正 传 ! 现在 我 们 的 首要 目标 是 存储 组 成 专辑 
的 曲目 ， 并 保证 曲目 的 正确 顺序 。 稍 后 ， 我 们 再 加 入 曲目 所 属 的 唱 
片 ， 以 及 曲目 在 该 唱片 的 位 置 等 信息 ， 这 样 才 可 以 妥善 地 处 理 包含 多 
个 唱片 的 专辑 。 


注意 : Wa, OS, etek ite ews... 


DAE A ti 


让 集合 内 容 保持 特定 的 顺序 其 实 相 当 人 简单 。 如 末 我 们 在 组 织 专 辑 
的 曲目 时 只 在 乎 这 一 点 ， 那 么 只 要 告诉 Hibernate 映 映 到 一 个 List 或 
Array 束 可 以 了 。 例 5-2 演 示 了 专辑 (Album) 映 映 中 我 们 使 用 的 方法 。 


例 5-2: 专辑 曲目 的 简单 排序 映射 


<list name="tracks"table="ALBUM_TRACKS" > 

<key column="ALBUM_ID"/> 

<list-index column="LIST_POS"/> 

<many - to-many 
class="com.oreilly.hh.data.Track"column="TRACK_ID"/> 

</list> 


这 与 我 们 一 直 在 用 的 set 映 射 十 分 相似 (虽然 这 里 使 用 了 一 个 不 同 
的 <list> 标 签 以 标明 这 个 集合 是 个 有 序 的 列表 ， 因 此 该 集合 会 映射 到 
一 个 java.util.List 类 ) 。 但 是 要 注意 ， 我 们 也 必须 额外 增加 一 个 list- 
index 标 签 ， 以 建立 这 个 列表 的 排序 字段 ， 同 时 ， 我 们 也 必须 在 数据 库 
中 新 增加 一 个 字段 来 保存 控制 曲目 顺序 的 值 。Hibernate 会 为 我 们 管理 
这 个 字段 的 内 容 ， 用 这 个 字段 来 确保 将 来 从 数据 库 把 列表 取出 时 ， 其 
内 容 会 和 当初 存储 到 数据 库 时 保持 相同 的 顺序 。 这 个 字段 的 类 型 是 整 
数 ， 可 能 的 话 ， 可 以 将 它 作 为 该 数据 库 表 的 组 合 主键 (composite 
key) 的 一 部 分 。 当 生成 HSQLDB 数 据 库 模 式 定 义 时 ， 就 可 以 用 例 5-2 
的 映射 内 容 来 生成 例 5-3 所 示 的 数据 表 。 


例 5-3: 简单 有 序曲 目 列表 的 HSQLDB 模 式 定 义 


[hibernatetool]create table ALBUM_TRACKS (ALBUM_ID INTEGER not 
null, 

TRACK_ID INTEGER not null, LIST_POS INTEGER not null, 

primary key (ALBUM_ID, LIST_POS) ) 


理解 LIST_POS 字 段 必 不 可 少 的 原因 征 很 重要 的 。 我 们 需要 控制 曲 
目 在 专辑 中 出 现 的 顺序 ， 但 是 曲目 目 身 并 没有 任何 属性 可 以 让 我 们 确 
定 它 在 专辑 中 的 顺序 《想象 一 人 下， 如果 播放 器 只 能 以 字母 顺序 来 播放 
专辑 的 曲目 时 ， 你 会 多 么 失望 一 竟然 不 能 按照 曲目 的 乞 人 顺序 播 
放 ) 。 关 系数 据 库 系统 的 基本 特性 就 是 ， 检 索 得 到 的 顺序 是 系统 认为 
方便 的 顺序 ， 除 非 指 定 了 系统 应 该 如 何 对 绪 采 进行 排序 。LIST_POS 字 


段 给 了 Hibernate 一 个 它 可 以 进行 控制 的 值 ， 可 以 用 于 确保 列表 总 是 以 
当初 创建 的 顺序 进行 排序 的 。 另 一 种 思考 方式 是 ， 数 据 项 的 顺序 是 我 
们 想 保 存 下 来 的 独立 信息 ， 所 以 Hibernate 需 要 有 个 地 方 来 保存 它 。 


随 之 而 来 的 结果 也 很 重要 。 如 条 数据 中 有 些 值 可 以 提供 饥 历 的 目 
然 顺 序 ， 那 就 没有 必要 再 提供 一 个 索引 字段 (index column) ， 甚 至 也 
不 需要 使 用 list。set 和 和 map 集合 映射 标签 束 提 供 了 一 个 sort 属 性 ， 通 过 
这 个 属性 可 以 配置 用 于 在 Java 中 排序 的 字段 ， 或 者 数据 库 本 映 也 提供 
了 一 个 用 于 排序 的 SQL order-by 属 性 ('!) 。 无 论 哪 一 种 情况 ， 当 志 
历 集合 的 内 容 时 ， 都 能 以 特定 的 顺序 获得 其 内 容 。 


LIST_POS 字 段 中 的 值 总 是 与 传递 给 tracks.get () 方法 的 参数 值 相 
同 ， 该 方法 用 于 获取 tracks 列 表 中 某 个 特定 位 置 上 的 值 。 


[1] 用 order-by 属 性 和 SQL 对 集合 进行 排序 的 功能 ， 只 有 Java SDK 1.4 或 
更 高 版 本 才 文 持 ， 因 为 这 需要 用 到 1.4 版 本 以 后 才 有 的 LinkedHashSet 或 
LinkedHashMap 类 。 


扩充 集合 中 的 天 联 


好 了 ， 如 采 我 们 想 把 专辑 中 的 曲目 按 一 定 的 顺序 排列 ， 现 在 已 经 
有 了 所 需要 的 解决 方法 。 那 么 ， 如 果 我 们 想 保 存 其 他 信息 ， 应 该 怎么 
办 ? 例如 曲目 是 在 哪 一 张 唱片 中 找到 的 ? 当 我 们 映 喘 一 个 关联 的 集合 
时 ， 我 们 已 经 知道 Hibernate 会 创建 一 个 连接 表 来 存储 对 象 之 间 的 关 
系 。 此 外 ， 我 们 也 知道 如 何在 ALBUM_TRACKS 表 中 增加 一 个 索引 字 
段 ， 以 保存 该 集合 元 素 的 顺序 。 理 想 情 况 下 ， 我 们 也 想 要 能 够 扩充 数 
据 表 的 内 容 ， 以 填 入 我 们 目 己 选择 的 信息 ， 以 便于 保存 专辑 曲目 的 其 
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事实 上 ， 我 们 也 可 以 做 好 这 件 事 情 ， 而 且 过 程 也 很 简单 。 


应 该 怎么 做 


到 目前 为 止 ， 我们 已 经 看 到 过 两 种 把 数据 表 放 进 数 据 库 模 式 的 方 
法 。 第 一 种 方法 是 明确 地 将 Java 对 象 的 属性 映射 到 数据 表 的 字段 ;第 二 
种 方法 是 定义 一 个 集合 ( 值 或 关联 的 ， 并 指定 用 于 管理 这 个 集合 的 
数据 表 和 字段 。 结 果 就 是 用 这 两 种 方法 创建 的 数据 表 的 使 用 是 一 样 
的 。 可 以 直接 用 该 数据 表 的 某 些 字 段 来 映射 对 象 的 属性 ， 而 同时 再 用 
其 他 字段 来 管理 集合 的 映射 。 这 样 可 以 让 我 们 在 实现 以 特定 的 顺序 来 


傈 存 专辑 曲目 的 同时 ， 还 能 够 通过 增加 其 他 细 市 来 扩展 数据 表 ， 以 文 
持 包 含 多 张 唱片 的 曲目 专辑 。 


注意 :这 种 灵活 性 要 人 花 点 时 间 来 习惯 ， 不 过 有 其 道理 所 在 。 尤 其 
是 如 果 你 想 将 对 象 映 冉 到 现 有 的 数据 库 模 式 时 。 


我 们 需要 一 个 新 的 数据 对 象 (AlbumTrack) ， 用 于 保存 有 关 曲 目 
在 专辑 中 的 使 用 方式 的 信息 。 由 于 我 们 已 经 实践 了 几 个 示例 ， 了 解 了 
如 何 映 射 完 整 而 独立 存在 的 实体 ， 因 此 AlbumTrack 对 象 实 在 没有 必要 
单独 存在 于 Album 实 体 的 范围 以 外 。 这 刚好 是 个 机 会 ， 可 以 看 一 看 组 件 
映射 是 怎么 回 事 。 回 想 一 下 ， 在 Hibernate 的 术语 中 ， 实 体 就 是 在 持久 
化 机 制 中 独立 存在 的 对 象 : 它 可 以 被 创建 、 查 询 以 及 删除 ， 这 些 操作 
都 独立 于 其 他 任何 对 象 ， 因 此 有 其 自身 的 持久 化 身份 (表现 为 它 必须 
具有 id 属性 ) 。 相 反 地 ， 组 件 虽 然 是 可 以 存储 到 数据 库 ， 也 能 从 数据 库 
检索 出 来 的 对 象 ， 但 它 只 是 其 他 实体 的 从 属 部 分 。 在 这 个 示例 中 ,我 
们 要 把 一 组 AlbumTrack 对 象 列表 定义 成 Album 实 体 的 组 件 。 例 5-4 就 是 
定义 这 一 关系 的 Album 类 的 映射 文件 。 


例 5-4: Album.hbm.xml (Album 类 的 映射 定义 ) 


<?xml version="1.0"?> 

<! DOCTYPE hibernate-mapping PUBLIC"-//Hibernate/Hibernate 
Mapping DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping> 

<class name="com.oreilly.hh.data.Album"table="ALBUM" > 

<meta attribute="class-description" > 


Represents an album in the music database, an organized list of 
tracks. 

@author Jim Elliott (with help from Hibernate) 

</meta> 

<id column="ALBUM_ID"name="id"type="int" > 

<meta attribute="scope-set">protected</meta> 

<generator class="native"/> 

</id> 

<property name="title"type="string"> 

<meta attribute="use-in-tostring">true</meta> 

<column index="ALBUM_TITLE"name="TITLE"not -null="true"/ > 

</property> 

<property name="numDiscs"type="integer"/> 

<set name="artists"table="ALBUM_ARTISTS" > 

<key column="ALBUM_ID"/> 

<many-to-many 
class="com.oreilly.hh.data.Artist"column="ARTIST_ID"/> 

</set> 

<set name="comments"table="ALBUM_COMMENTS" > 

<key column="ALBUM_ID"/> 

<element column="COMMENT"type="string"/ > 

</set> 

<list name="tracks"table="ALBUM_TRACKS" > @ 

<meta attribute="use-in-tostring">true</meta> 

<key column="ALBUM_ID"/> 

<index column="LIST_POS"/ > 

<composite-element class="com.oreilly.hh.data.AlbumTrack">@ 

<many-to-one class="com.oreilly.hh.data.Track"name="track" > © 

<meta attribute="use-in-tostring">true</meta> 

<column name="TRACK_ID"/> 

</many -to-one> 

<property name="disc"type="integer"/>® 

<property name="positionOnDisc"type="integer"/>® 

</composite-element > 

</list> 

<property name="added"type="date" > 

<meta attribute="field-description" > 

When the album was created</meta> 

</property> 

</class> 

</hibernate-mapping > 


在 创建 好 Album.hbm.xml 以 后 ， 还 需要 将 它 添加 到 hibernate.cfg.xml 
的 映射 资源 列表 中 。 打 开 src 目 隶 下 的 hibernate.cfg.xml 文 件 ， 将 例 5-5 中 


用 粗 体 突出 显示 的 那 一 行 添 加 a 到 这 个 文件 中 。 
例 5-5: 将 Album.hbm.xml 添 加 到 Hibernate 配 置 文件 中 


<?xml version='1.0'encoding='utf-8'?> 

<! DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-configuration- 
3.0.dtd"> 

<hibernate-configuration> 

<session-factory> 

<mapping resource="com/oreilly/hh/data/Track.hbm.xm1l"/> 

<mapping resource="com/oreilly/hh/data/Artist.hbm.xmL"/> 

<mapping resource="com/oreilly/hh/data/Album.hbm.xm1"/> 

</session-factory> 

</hibernate-configuration> 
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值得 我 们 仔细 探讨 。 关 于 讨论 的 内 容 ， 先 回想 一 下 刚才 我 们 客 竟 想 做 
We 


我 们 想 要 让 专辑 里 的 曲目 列表 保持 一 定 的 顺序 ， 同 时 又 能 为 每 个 
曲目 增加 一 些 额 外 的 信息 ， 以 指出 曲目 所 属 的 唱片 (专辑 包括 多 张 唱 
片 的 情况 ) ， 以 及 该 曲目 在 唱片 中 的 位 置 。 这 种 关系 的 概念 如 图 5-1 的 
中 部 内 容 所 示 。 专 辑 和 曲目 之 间 的 关联 是 由 "AlbumTrack" 对 象 作为 媒 
介 而 体现 的 ， 这 个 对 象 新 增加 了 唱片 和 位 置信 息 ， 并 保证 曲目 以 正确 
的 顺序 排列 。 曲 目 对 和 象 本 身 的 模型 我 们 已 经 很 熟悉 了 (此 图 中 ， 为 了 
保持 简单 ， 我 们 删 去 了 艺人 和 评论 信息 ) ， 这 个 模型 正 是 我 们 在 专辑 
映射 文档 中 需要 使 用 的 ( 例 5-4) 。 让 我 们 讨论 其 中 的 细节 吧 。 稍 后 ， 


我 们 会 介绍 Hibernate 如 何 将 这 样 的 映射 配置 规定 转换 成 Java 代 码 (图 5- 
1 的 底部 部 分 ) 和 数据 库 模 式 (图 5-1 的 顶部 部 分 ) 。 


好 吧 ， 有 了 这 一 概念 性 框架 的 提示 和 描述 ， 我 们 接 下 来 束 看 看 例 5- 


4 的 细节 内 容 : 


@ 如 果 拿 前 一 章 的 集合 映射 定义 和 这 里 的 列表 定义 进行 比较 ， 你 
会 发 现 它们 之 间 存 在 很 多 相似 之 处 。 它 看 起 来 甚至 更 像 例 5-2， 只 是 关 
联 映 射 定义 已 经 移 到 一 个 新 的 composite-element 有 映射 元 素 内 部 了 。 


@ 这 个 元 素 引 入 新 的 AlbumTrack 对 象 ， 我 们 用 它 来 分 组 唱片 、 位 
置 以 及 组 织 专 辑 曲 目 所 需要 的 Track 链接 。 


日 此 外 ，AlbumTrack 和 Track 之 间 的 关联 是 多 对 一 的 〈 不 是 多 对 多 
的 映射 ， 因 为 专辑 通常 包含 数 个 曲目 ， 而 特定 曲目 文件 可 能 在 几 个 专 
辑 之 间 共 享 ) : 如 果 我 们 为 了 节省 磁 副 空间 ， 几 个 AlbumTrack 对 象 
(来 自 不 同 专辑 ) 可 能 会 引用 相同 的 Track 文件 ， 但 每 一 个 AlbumTrack 
对 象 只 与 一 个 Track 相关 。 包 含 AlbumTrack 的 list 标 签 隐 含 是 一 对 多 的 关 
系 《如 果 这 些 数据 建 模 概 念 让 你 很 困惑 ， 现 在 不 用 太 花 费 精 力 去 弄 懂 
这 些 ， 源 代码 和 数据 库 模 式 马上 就 会 出 来 ， 希 望 有 助 于 你 明白 这 到 底 
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好 了 ， 继 续 从 整体 上 考虑 一 下 这 个 新 的 composite-element 元 素 定 
义 。 这 个 元 素 指 出 我 们 想 要 用 一 个 新 的 AlbumTrack 类 作为 Album 数 据 


bean 的 曲目 列表 中 的 值 。composite-element 标 签 的 主体 定义 了 
AlbumTrack 的 各 个 属性 ， 把 专辑 中 一 个 曲目 的 所 有 信息 都 汇集 在 这 儿 
了 。 这 些 租 套 属性 的 映射 语法 和 外 层 Album 目 喘 属性 的 映射 语法 并 没有 
什么 不 同 ， 甚 至 还 能 包含 自己 的 租 套 复合 元 素 、 集 合 或 meta 元 素 (如 
此 处 所 示 ) 。 这 让 我 们 在 建立 细 粒 度 的 映射 上 具有 相当 大 的 灵活 性 ， 
同时 也 保留 了 一 定 恨 好 程度 的 面向 对 象 的 封装 。 


在 我 们 的 复合 AlbumTrack 有 映 射 中 ， 我 们 要 记录 和 实际 Track 之 间 的 
关联 (刚才 介绍 的 many-to-one 元 素 ) ， 以 及 该 曲目 在 专辑 中 的 播放 位 
PE 


@ 复 合 映射 也 需要 保存 曲目 所 属 的 唱片 的 编号 。 


人 @ 最 后 也 要 保存 该 曲目 在 唱片 中 的 位 置 《例如 第 2 号 唱 族 的 第 3 首 
HEL) ° 


这 一 映射 取得 了 我 们 先前 的 既定 目标 ， 也 就 是 可 以 将 任意 的 信息 
附加 到 关联 集合 


组 件 类 本 喘 的 源 代码 如 例 5-6 所 示 ， 它 有 助 于 前 明 相关 讨论 。 可 以 
对 比 一 下 该 源 代 码 和 它 的 图 形 表示 图 5-1 诡 部 。 


ws 


id: int 
title:Strin 
numDiscs:in 
added:Date 
tracks: List 


disc: int 
Pr on es int 
rack.com.oreilly.hh.Track 
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图 5-1 表示 专辑 曲目 所 涉及 的 数据 表 、 概 念 、 以 及 对 象 的 模型 


可 以 看 到 ， 我 们 选择 TRACK_ID 的 字段 名 称 作为 链接 到 TRACK 表 
的 多 对 一 (many-to-one) 关联 的 连接 字段 。 这 样 的 处 理 在 前 面 已 经 过 
到 过 很 多 次 了 ， 但 之 前 都 不 需要 独立 成 一 行 。 这 里 值得 讨论 一 下 这 样 
选择 的 原因 。 没 有 这 条 指令 ，Hibernate 将 只 会 用 属性 名 (track) 作为 
字段 名 称 。 你 的 字段 可 以 使 用 任何 名 称 ， 但 《Java Database Best 
Practices》 一 书 鼓励 我 们 把 外 键 (foreign key) 字段 命名 成 和 其 引用 的 
原来 数据 表 里 的 主键 (primary key) 的 名 称 相 同 。 这 有 助 于 数据 建 模 工 
具 识 别 并 显示 外 键 所 代表 的 “自然 连接 ” (natural join) ， 也 可 以 让 人 更 
容易 理解 和 使 用 数据 。 出 于 这 种 考虑 ， 我 们 就 将 数据 表 名 称 作 为 主键 
字段 名 称 的 一 部 分 。 
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我 原本 以 为 ， 由 于 选择 使 用 composite 元 素来 封装 扩充 过 的 曲目 列 
表 ， 承 得 自己 编写 AlbumTrack 类 的 Java 源 代码 ， 而 这 会 超出 代码 生成 工 
具 能 力 所 及 的 范围 。 但 是 出 手 意 料 的 是 ， 当 我 试 着 执行 ant codegen 命 
令 ， 想 看 看 有 什么 错误 信息 会 出 现时 ， 没 想到 这 个 命令 居然 报告 成 


功 ， 源 代码 目录 下 出 现 了 Album.java 和 AlbumTrack.java 这 两 个 文件 ! 


注意 : 偶尔 证 明 是 错 的 也 不 为 过 。 


这 时 ， 我 再 回 过 头 来 为 组 件 内 曲目 的 多 对 一 映射 新 增 了 一 个 use-in- 
tostring 的 meta 元 素 。 我 不 确信 这 是 人 否 行 得 通 ， 因 为 我 在 参考 文档 中 惧 
一 找到 的 使 用 示例 都 是 附加 在 property 标 签 以 内 。 但 是 居然 行 得 通 ， 这 
和 我 原来 希望 的 一 样 。 


N 


Hibernate 最 佳 实践 鼓励 我 们 使 用 细 粒 度 的 (fine-grained) 持久 化 
类 ， 再 将 它们 映 喘 为 组 件 。 代 码 生 成 工具 可 以 轻易 地 根据 映射 文档 来 
创建 持久 化 类 的 源 代码 ， 绝 对 没有 借口 而 对 这 一 建议 视而不见 。 例 5-6 
演示 了 为 舱 套 的 组 件 映 射 生 成 的 源 代 码 。 


例 5-6: 为 AlbumTrack.java 生 成 的 代码 


package com.oreilly.hh.data; 

//Generated Jun 21, 2007 11: 11: 48 AM by Hibernate Tools 3.2.0.b9 

JER 

*Represents an album in the music database, an organized list of 
tracks. 

*@author Jim Elliott (with help from Hibernate) 

*/ 

public class AlbumTrack implements java.io.Serializable{ 

private Track track; 

private Integer disc; 

private Integer positionOnDisc; 

public AlbumTrack () { 


} 

public AlbumTrack (Track track, Integer disc, Integer 
positionOnDisc) { 

this.track=track; 

this.disc=disc; 

this .positionOnDisc=positionOnDisc; 


public Track getTrack () { 
return this.track; 


} 
public void setTrack (Track track) { 
this.track=track; 


public Integer getDisc () { 
return this.disc; 


public void setDisc (Integer disc) { 
this.disc=disc; 


} 
public Integer getPositionOnDisc () { 
return this.positionOnDisc; 


public void setPositionOnDisc (Integer positionOnDisc) { 

this.positionOnDisc=positionOnDisc; 

} 

SER 

*toString 

*@return String 

=f 

public String toString () { 

StringBuffer buffer=new StringBuffer () ; 

buffer.append (getClass () .getName () ) .append ("@") .append ( 

Integer.toHexString (hashCode () ) ) .append ("[") ; 

buffer.append ("track") .append ("='") .append (getTrack 
Q ) .append ("'") ; 

buffer.append ("]") ; 

return buffer.toString () ; 

} 

} 


这 段 代 码 看 起 来 和 前 几 章 为 实体 生成 的 代码 差不多 ， 但 是 此 处 少 
了 一 个 id 属性 ， 这 是 有 道理 的 。 组 件 类 不 需要 标识 符 字 段 ， 也 不 需要 实 
现任 何 特殊 接口 。 这 个 类 和 Album 类 共享 同样 的 JavaDoc， 而 在 Album 
类 中 整 使 用 了 该 组 件 类 。Album 类 的 源 代码 古典 型 的 代码 生成 工具 生成 
的 实体 ， 所 以 这 里 不 再 芍 述 。 


现在 ， 我 们 可 以 通过 ant schema 命 令 为 这 些 新 的 映射 文档 建立 数据 
库 模 式 了 。 例 5-7 演 示 了 模式 创建 结果 的 重点 内 容 ， 这 就 是 图 5-1 顶 端 模 
式 模型 的 具体 HSQLDB 表 示 。 


例 5-7: 由 新 的 Album 有 映射 所 增加 的 数据 库 模 式 


[hibernatetool]create table ALBUM (ALBUM_ID integer generated by 
default 

as identity (start with 1) , TITLE varchar (255) not null, 

numDiscs integer, added date, primary key (ALBUM_ID) ) ; 

[hibernatetool]create table ALBUM_ARTISTS (ALBUM_ID integer not 
null, 

ARTIST_ID integer not null, 

primary key (ALBUM_ID, ARTIST_ID) ) ; 

[hibernatetool]create table ALBUM_COMMENTS (ALBUM_ID integer not 
null, 

COMMENT varchar (255) ) ; 

[hibernatetool]create table ALBUM_TRACKS (ALBUM_ID integer not 
null, 

TRACK_ID integer, disc integer, positionOnDisc integer, LIST_POS 
integer not null, 

primary key (ALBUM_ID, LIST_POS) ) ; 

[hibernatetool]create index ALBUM_TITLE on ALBUM (TITLE) , ...... 

[hibernatetool]alter table ALBUM_ARTISTS add constraint 
FK7BA403FC620962DF 

foreign key (ARTIST_ID) references ARTIST; 

[hibernatetool]alter table ALBUM_ARTISTS add constraint 
FK7BA403FC3C553835 

foreign key (ALBUM_ID) references ALBUM; 

[hibernatetool]alter table ALBUM_COMMENTS add constraint 
FK1E2C21E43C553835 

foreign key (ALBUM_ID) references ALBUM; 

[hibernatetool]alter table ALBUM_TRACKS add constraint 
FKD1CBBC782DCBFAB5 

foreign key (TRACK_ID) references TRACK; 

[hibernatetool]alter table ALBUM_TRACKS add constraint 
FKD1CBBC783C553835 

foreign key (ALBUM_ID) references ALBUM; 


你 可 能 发 现 ， 对 数据 库 模 式 做 一 些 天 键 的 修改 会 导致 Hibernate 或 
HSQLDB 了 驱动 程序 发 生 问 题 。 当 我 换 用 这 种 新 方法 来 建立 专辑 曲目 的 


映射 时 ， 遇 到 了 麻烦 ， 因 为 第 一 组 映射 会 建立 一 些 数据 库 约束 ， 而 
Hibernate 在 试图 重新 建立 模式 时 并 不 知道 应 该 移 删除 这 些 约束 。 这 样 
就 不 能 继续 删除 和 重新 创建 某 些 数据 表 了 。 如 果 你 也 遇 到 了 这 种 问 
题 ， 可 以 先 删 除数 据 库 文件 (data 目 录 下 的 music.script 文 件 ) ， 再 从 头 
开始 ， 应 该 就 没有 问题 了 。 和 针对 这 些 情况 ，Hibermate 最 新 版 本 的 健壮 
性 似乎 有 所 增强 。 


图 5-2 展 示 了 HSQLDB 图 形 管理 界面 中 扩展 后 的 数据 库 模式 。 


你 可 能 会 问 ， 冤 竟 为 什么 要 用 这 么 一 个 单独 的 Track 类 ， 而 不 是 直 
接 把 所 有 信息 都 放 在 扩充 后 的 AlbumTrack 集 合 中 。 答 案 很 简单 ， 并 不 
征 所 有 曲目 都 属于 菏 个 专辑 ， 有 些 也 许 是 单 曲 、 下 载 而 来 的 或 其 他 单 
独 的 曲目 。 既 然 我 们 已 经 用 一 个 单独 的 数据 表 来 记 杂 这 些 数据 ， 所 以 
再 在 AlbumTracks 表 中 重复 其 内 容 而 非 建立 与 Track 表 的 关联 ， 将 是 一 种 
很 糟糕 的 设计 。 采 用 这 种 方法 (我 自己 的 音乐 数据 库 就 是 用 这 种 方 
法 ) ， 还 有 男 一 个 微妙 的 优点 ， 这 样 的 结构 能 让 我 们 在 多 个 专辑 中 共 
享 同一 个 曲目 。 如 果 有 专辑 、 精 选集 以 及 某 个 或 多 个 年 代 的 选集 都 出 
现 了 相同 曲目 ， 把 这 些 曲 目 集 都 链接 到 相同 的 曲目 束 可 以 节省 磁 副 空 
间 。 


eoo HSQL Database Manager 
E Jdbc:hsqidb:data/music | 
Clear 


E ALBUM 
schema: PUBLIC 
国 ALBUM_ID 
国 TITLE 
国 NUMDISCS 
@ ADDED 
f Indices 
E ALBUM_ARTISTS 
E ALBUM COMMENTS 
E ALBUM_TRACKS 
schema: PUBLIC 


Execute | 


国 POSITIONONDISC 
 LIST_POS 
f Indices 
ARTIST 
f TRACK 
E TRACK_ARTISTS 
D TRACK COMMENTS 
E Properties 


图 5-2 专辑 相关 数据 表 的 模式 


ALBUM_TRACK 模 式 中 另 一 个 值得 注意 的 地 方 是 它 没有 明显 的 ID 
字段 。 如 果 查 看 例 5-7 中 Hibemate 为 ALBUM_TRACK 生 成 的 模式 定义 ， 
可 以 看 到 主键 是 通过 primary key (ALBUM_ID, LIST_POS) 这 样 的 语 
句 定义 的 。Hibernate 已 经 知道 ， 根 据 我 们 在 Album.hbm.xml 中 要 求 的 映 
射 关 系 ，ALBUM_TRACK 表 中 的 某 一 行 可 以 由 Album (专辑 ) 的 ID 和 
曲目 在 列表 中 的 索引 而 惟一 确定 ， 所 以 Hibernate 为 这 个 表 建 立 了 一 个 


复合 主键 (composite key) 。 对 于 这 一 优化 ， 我 们 不 需要 过 多 讨论 。 还 
要 注意 ， 这 些 列 中 有 一 个 类 型 是 AlbumTrack 类 的 属性 ， 而 其 他 列 则 不 
是 。 在 第 7 章 中 ， 我 们 将 以 另 一 种 稍微 不 同 的 方式 来 建立 这 一 关系 模 


F 


Ses 


(一 
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我 们 来 看 看 示例 程序 代码 ， 以 了 解 如 何 使 用 这 些 新 的 数据 对 象 。 
例 5-8 演 示 的 类 会 创建 一 个 专辑 记录 和 一 列 曲 目 ， 然 后 通过 配置 好 的 
toString () 方法 来 打印 输出 测试 调试 数据 。 


例 5-8: AlbumTest.java 的 源 代码 


package com.oreilly.hh; 

import org.hibernate.*; 

import org.hibernate.cfg.Configuration; 

import com.oreilly.hh.data.*; 

import java.sql.Time; 

import java.util.*; 

/** 

*Create sample album data, letting Hibernate persist it for us.*/ 

public class AlbumTest{ 

[tt 

*Quick and dirty helper method to handle repetitive portion of 
creating 

*album tracks.A real implementation would have much more 
flexibility. 

*/ 

private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 

int positionOnDisc, Session session) {@ 

Track track=new Track (title, file, length, new HashSet<Artist> 


new Date () , (short) ©, new HashSet<String> () ) ; 

track.getArtists () .add (artist) ; @ 

session.save (track) ; 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ) ; ©} 


public static void main (String args[]) throws Exceptiont{ 
//Create a configuration based on the properties file we've put 
//in the standard place. 
Configuration config=new Configuration () ; 
config.configure () ; 
//Get the session factory we can use for persistence 
SessionFactory sessionFactory=config.buildSessionFactory () ; 
//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 
Transaction tx=null; 
try{ 
//Create some data and persist it 
tx=session.beginTransaction () ; 
Artist artist=CreateTest.getArtist ("Martin L.Gore", true, 
session) ; 
Album album=new Album ("Counterfeit e.p.", 1, 
new HashSet<Artist> () , new HashSet<String> () , 
new ArrayList<AlbumTrack> (5) , new Date () ) ; 
album.getArtists () .add (artist) ; 
session.save (album) ; 
addAlbumTrack (album, "Compulsion", "vol1/album83/track01.mp3", 
Time.valueOf ("00: 05: 29") , artist, 1, 1, session) 
addAlbumTrack (album, "In a Manner of Speaking", 
"voli/album83/track02.mp3", Time.valueOf ("00: 04: 21") , 
artist, 1, 2, session) ; 
addAlbumTrack (album, "Smile in the Crowd", 
"vyol1/album83/track03.mp3", Time.valueOf ("00: 05: 06") , 
artist, 1, 3, session) ; 
addAlbumTrack (album, "Gone", "vol1/album83/track04.mp3", 
Time.valueOf ("00: 03: 32") , artist, 1, 4, session) 
addAlbumTrack (album, "Never Turn Your Back on Mother Earth", 
"vol1/album83/track05.mp3", Time.valueOf ("00: 03: 07") , 
artist, 1, 5, session) ; 
addAlbumTrack (album, "Motherless 

Child", "voli/album83/track06.mp3", 
Time.valueOf ("00: 03: 32") , artist, 1, 6, session) 
System.out.println (album) ; 
//We're done; make our changes permanent 
tx.commit () ; 
//This commented out section is for experimenting with deletions. 
//tx=session.beginTransaction () ; 
//album.getTracks () .remove (1) ; 
//session.update (album) ; 
//tx.commit () ; 
//tx=session.beginTransaction () ; 
//session.delete (album) ; 
//tx.commit () ; 
}catch (Exception e) { 


if (tx! =null) { 

//Something went wrong; discard all partial changes 
tx.rollback () ; 

} 

throw new Exception ("Transaction failed", e) ; 
}finally{ 

//No matter what, close the session 

session.close () ; 


//Clean up after ourselves 
sessionFactory.close () ; 


} 
} 


@ 首 先 ，addAlbumTrack () 方法 会 根据 指定 的 参数 创建 一 个 Track 
对 象 ， 并 将 之 持久 保存 。 


@@ 其 次 ， 将 新 的 曲目 和 一 个 Artist 对 象 建立 关联 。 


日 最 后 ， 将 曲目 对 象 加 到 Album 内 ， 记 录 所 属 的 唱片 以 及 在 该 唱片 
Aine ° 


在 这 个 示例 中 ， 我 们 创建 了 一 个 只 有 一 张 唱片 的 专辑 。 虽 然 这 种 
快速 而 简单 的 方法 并 不 能 处 理 其 他 各 种 应 用 需求 ， 但 这 样 可 以 让 示例 
更 简 活 一 些 。 


为 了 调用 这 个 类 ， 还 需要 在 build.xml 的 末尾 增加 一 个 新 的 ant 构 建 
目标 ， 将 例 5-9 的 内 容 添 加 到 该 文件 的 结尾 处 (当然 ， 应 该 在 project 元 
素 的 内 部 ) 。 


例 5-9: 运行 AlbumTest 类 需要 的 ant 构 建 目标 


<target name="atest"description="Creates and persists some album 
data" 

depends="compile" > 

<java classname="com.oreilly.hh.AlbumTest"fork="true" > 

<classpath refid="project.class.path"/> 

</java> 

</target> 


准备 好 以 后 ， 假 定 已 经 生成 了 数据 库 模 式 ， 接 着 束 依 次 执行 ant 
ctest 和 ant atest (和 完 运行 ctest 并 不 是 必需 的 ， 但 是 ， 测 试 开始 时 有 些 额 
外 的 数据 ， 会 让 专辑 数据 变 得 更 有 趣 些 。 回 想 一 下 ， 你 也 可 以 只 用 一 
行 命令 来 运行 这 些 构建 目标 : ant ctest atest。 如 果 想 在 开始 时 先 把 数据 
库 的 内 容 清 除 掉 ， 则 可 以 执行 ant schema ctest atest) 。 这 个 命令 产生 的 
调试 输出 信息 如 例 5-10 所 示 。 虽 然 有 些 难 懂 ， 但 是 应 该 可 以 看 出 来 这 段 
代码 创建 好 了 专辑 和 曲目 数据 ， 而 且 还 保留 了 曲目 的 顺序 。 


例 5-10: 运行 专辑 测试 的 输出 


atest: 

[java]com.oreilly.hh.data.Album@5bcf3a[title='Counterfeit 
e.p.'tracks='[ 

com.oreilly.hh.data.AlbumTrack@6a346a[track='com.oreilly.hh.data. 
Track@973271[ 

title='Compulsion'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], c 

om.oreilly.hh.data.AlbumTrack@8e0e1[track='com.oreilly.hh.data.Tr 
ack@e3f8b9[ ti 

tle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia=' 

CD ] ]， 
com.oreilly.hh.data.AlbumTrack@de59f0[track='com.oreilly.hh.data.Tra 
C 

k@e2d159[title='Smile in the Crowd'volume='Volume[left=100, 
right=100]'source 

Media='CD']'], 
com.oreilly.hh.data.AlbumTrack@1e5a36[track='com.oreilly.hh.da 


ta. Track@b4bb65[title='Gone'volume='Volume[left=100, 
right=100]'sourceMedia=' 

CD ] ]， 
com.oreilly.hh.data.AlbumTrack@7b1683[track='com.oreilly.hh.data.Tra 
C 

k@3171e[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, r 

ight=100] 'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@e2e4d7[track=' 

com.oreilly.hh.data.Track@idfc6e[title='Motherless 
Child 'volume='Volume[left=1 

00, right=100]'sourceMedia='CD']']]'] 


如 采 执 行 原来 的 查询 测试 ， 会 同时 看 到 新 旧 数 据 ， 如 例 5-11 所 示 。 
例 5-11: 无 论 是 否 来 目 专辑 ， 所 有 曲目 的 播放 时 间 都 小 于 7 分 钟 


%ant qtest 
Buildfile: build.xml 
qtest: 
ava]Track: ussian Trance 
j Track: "Russian T " (PPK) 00: 03: 30 
[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 
Samuel Barber, William Orbit) 00: 06: 35 
ava]Track: est Tone 
j T k: "Test T 1"00: 00: 10 
ava]Comment: Pink noise to test equalization 
java]c t: Pink noise to test equalizati 
ava]Track: ompulsion artin L.Gore 
j Track: "Compulsion" (Martin L.Gore) 00: 05: 29 
ava]Track: n a Manner o eakin artin L.Gore ; : 
j Track: "I M f Speaking" (Martin L.Gore) 00: 04 
21[java]Track: "Smile in the Crowd" (Martin L.Gore) 00: 05: 06 
[java]Track: "Gone" (Martin L.Gore) 00: 03: 32 
[java]Track: "Never Turn Your Back on Mother Earth" (Martin 
L.Gore) 
00: 03: 07 
[java]Track: "Motherless Child" (Martin L.Gore) 00: 03: 32 
BUILD SUCCESSFUL 
Total time: 2 seconds 


最 后 ， 图 5-3 显 示 了 在 HSQLDB 界 面 中 检索 ALBUM_TRACKS 表 内 


日 jdbc: hsqidb: data/music 
E ALBUM 
schema: PUBLIC 
国 ALBUM_ID 
TITLE 
© NUMDBCS 
国 ADDED 
国 Indices 
-E ALBUM_ARTISTS 
E ALBUM COMMENTS 
HE ALBUM TRACKS 
schema: PUBLIC 
@ ALBUM_ID 
国 TRACKID 
国 DEC 
国 POSITIONONDISC 
国 LIST_FOS 
Indices 
@ ARTIST 
E TRACK 
HE TRACK_ARTISTS 
HE TRACK COMMENTS 


图 5-3 


删除 集合 元 素 、 重 新 排列 以 及 其 他 对 
理 ? 这 些 处 理 都 是 目 动 文 持 的 ， 下 一 世 将 


这 
A 
B 


内 容 经 过 扩充 后 的 关联 集合 


些 相互 天 联 的 信 ， 


电 的 处 


天 联 的 生命 周期 


Hibernate 完 全 负责 ALBUM_TRACKS 表 的 管理 ， 当 为 Album bean 
的 tracks 属 性 增加 或 删除 数据 项 时 ，Hibernate 会 目 动向 
ALBUM_TRACKS 表 中 增加 或 删除 相应 的 记录 行 (必要 时 会 重新 计算 
LIST_POS 值 ) 。 可 以 写 个 测试 程序 进行 测试 ， 从 我 们 的 测试 专辑 中 删 
除 第 2 个 曲目 ， 然 后 看 看 结果 如 何 。 一 种 快速 而 简单 的 做 法 束 是 将 下 列 
4 行 代码 (如 例 5-12 所 示 ) 添加 到 例 5-8 中 已 有 的 tx.commit O 那 一 行 的 


后 面 ， 然 后 执行 ant schema ctest attest db 命令 。 
例 5-12: 删除 专辑 的 第 2 个 曲目 


tx=session.beginTransaction () ; 
album.getTracks () .remove (1) ; 
session.update (album) ; 
tx.commit () ; 


这 样 做 会 改变 ALBUM_TRACKS 表 中 的 内 容 ， 如 图 5-4 所 示 (和 图 
5-3 的 原始 内 容 相 比较 ) 。 第 2 条 记录 已 经 被 删除 ( 记 住 ，Java 列 表 元 素 
的 索引 值 是 从 0 开始 的 ) ， 而 LIST_POS 也 做 了 调整 以 保证 其 连续 性 ， 
以 便 与 列表 元 素 的 索引 可 以 相对 应 (调用 tracks.get O 所 用 的 参数 
值 ) 。 


e080 HSQL Database Manager , 
\ select * from album_tracks 


B jdbc:hsaldb: data/music 
国 ALBUM 
国 ALBUM ARTISTS 
国 ALBUM COMMENTS 
国 ALBUM_TRACKS 


ARTIST ALBUM _ID|TRACK_ID |DISC | POSITIONONDISC |LIST_POS| 
TRACK 


国 TRACK_ARTISTS 
国 TRACK COMMENTS 
E Propenies 


图 5-4 删除 专辑 的 第 2 个 曲目 后 的 专辑 曲目 关联 


之 所 以 这 样 ， 是 因为 Hibernate 明 白 这 个 列表 是 由 Album 表 的 记 
录 “ 拥 有 ”的 ， 而 这 两 个 对 象 的 “生命 周期 ”(lifecycle) 彼此 紧密 相连 。 
设想 一 下 ， 如 果 整 个 Album 表 的 内 容 都 被 删除 会 发 生 什么 事 : 
ALBUM_TRACKS 里 所 有 相关 联 的 记录 也 会 跟着 被 删除 (如 果 你 不 
言 ， 可 以 修改 测试 程序 来 试 试看 ) 。 这 么 一 想 ， 生 命 周期 的 概念 就 变 
得 更 为 清晰 了 。</p> 


= 


ALBUM#FITRACK# Z [AINA RAIA] To HA APY eA TH 
关联 ， 但 有 时 也 是 独立 的 。 从 列表 中 删除 一 个 曲目 ， 束 会 导致 清除 
ALBUM_TRACKS 表 中 相应 的 一 行 记录 ， 专 辑 和 曲目 之 间 的 关联 也 随 
之 消失 ， 但 并 不 会 删除 TRACK 表 中 的 记录 行 ， 所 以 这 么 做 也 不 会 删除 
持久 化 Track 对 象 本 身 。 同 样 地 ， 删 除 Album 对 象 会 把 集合 中 所 有 的 关 


联 都 清除 ， 但 所 有 实际 的 Track 对 象 都 不 受 影响 。 我 们 的 代码 只 是 负责 
在 适当 的 时 机 进行 这 些 操作 (或 许 在 向 用 户 咨询 以 后 ， 说 不 定 有 些 曲 
目 记 录 可 以 在 多 个 专辑 中 共享 ， 如 前 所 壕 ) 


如 果 我 们 不 需要 在 专辑 之 间 共 享 相同 曲目 的 灵活 性 (对 于 压缩 的 
首 频 文件 的 体积 来 说 ， 其 占用 的 磁盘 空间 最 近 相 当 便 宜 ) ， 也 可 以 让 
Hibernate 以 管理 ALBUM_TRACKS 和 集合 的 相同 方式 来 管理 专辑 的 
TRACK 记 杂 。Hibernate 当 然 不 会 以 为 它 应 该 这 么 做 ， 因 为 Track 和 
Album 对 象 能 彼此 独立 存在 ， 但 是 我 们 可 以 在 专辑 映射 文档 中 为 二 者 之 
间 建 立 生 命 周期 关系 。 


注意 : 现在 ， 已 经 知道 有 可 以 自动 化 处 理 这 些 的 方式 ， 可 能 不 会 
再 感到 吃惊 了 吧 。 


应 该 怎么 做 


例 5-13 展 示 了 我 们 对 Album.hbm.xml 里 的 tracks 必 性 映射 做 出 的 修改 
(以 粗 体 表示 ) 


例 5-13: 为 专辑 和 它 的 曲目 建立 生命 周期 关系 


<list name="tracks"table="ALBUM_TRACKS"cascade="al1" > 
<meta attribute="use-in-tostring">true</meta> 

<key column="ALBUM_ID"/> 

<index column="LIST_POS"/ > 

<composite-element class="com.oreilly.hh.AlbumTrack" > 
<many-to-one class="com.oreilly.hh.Track"name="track" 


cascade="all"> 

<meta attribute="use-in-tostring">true</meta> 
<column name="TRACK_ID"/> 

</many -to-one> 

<property name="disc"type="integer"/> 
<property name="positionOnDisc"type="integer"/ > 
</composite-element > 

</list> 


cascade 属 性 用 于 告诉 Hibernate， 需 要 将 “ 父 ”(parent) 对 象 上 施加 
的 操作 也 应 用 到 它 的 “ 子 ”(child) 或 “依赖 ”(dependent) 对 象 上 。 这 一 
属性 适用 于 所 有 形式 的 集合 和 关联 。 它 有 几 种 可 供 选 择 的 预 设 值 ， 最 
常见 的 是 none (默认 值 )、save-update、delete 以 及 all (组 合 了 save- 
update 和 delete) 。 还 可 以 通过 在 hibernate-mapping 标 签 内 部 提供 一 个 
default-cascade 属 性 ， 将 整个 映射 文档 范围 内 的 默认 值 从 none 变 为 save- 


update ° 


整 此 例 而 言 ， 我 们 希望 专辑 所 包含 的 曲 日 都 由 专辑 目 动 管理 ， 这 
样 ， 当 删除 某 个 专辑 时 ， 它 的 曲目 也 会 随 之 删除 。 注 意 ， 我 们 必须 为 
tracks 集 合 和 组 成 它 的 track 元 素 都 应 用 cascade 属 性 ， 才 能 做 到 这 一 点 。 
此 外 ， 将 cascade 属 性 设置 为 al 时 ， 束 不 用 再 明确 保存 我 们 为 专辑 而 创 
建 的 任何 Track 对 象 ， 也 就 是 例 5-8 中 的 addAlbumTrack () 方法 不 再 需 
要 以 下 这 行 : 


session.save (track) : 


通过 告诉 Hibernate 让 它 负 责 维护 专辑 及 其 曲目 之 间 的 关联 关系 ， 
就 可 以 让 Hibernate 在 曲目 被 加 进 专 辑 时 自动 将 曲目 对 象 《Track 对 象 ) 
持久 保存 ， 同 时 在 删除 专辑 时 也 可 以 删除 相关 的 所 有 曲目 。 


Hibernate 对 生命 周期 关系 的 管理 并 不 是 十 分 安全 的 (fool- 

proof) ， 或 许 更 准确 地 说 ， 它 并 非 是 无 所 不 包 的 。 例 如 ， 如 果 使 用 
Collections 接 口 的 方法 从 Album 的 tracks 属 性 中 删除 一 个 Track 对 象 ， 这 
样 会 打 断 Album 和 Track 之 间 的 关联 ， 但 实际 上 并 不 会 删除 那个 Track 对 
象 对 应 的 记录 。 即 使 以 后 把 整个 Album 删 除 掉 ， 那 个 Track 还 会 保留 
着 ， 因 为 删除 Album 的 时 候 ， 原 来 被 删除 的 那个 Track 已 经 没有 和 被 删 
除 的 Album 之 间 有 关联 了 “。 适 当 修改 AlbumTestjava 就 能 做 一 些 这 类 实 
验 ， 看 看 数据 表 中 最 后 的 结果 ! 


事实 上 ， 在 某 些 特定 的 情况 下 ，Hibernate 可 以 负责 处 理 这 种 级 别 
的 细节 。 只 要 在 父子 关系 中 使 用 多 对 一 (many-to-one) 映射 ， 就 可 以 
将 映射 的 cascade 属 性 标识 为 delete-orphan。 相 关 的 更 多 细节 可 以 查阅 
Hibernate 在 线 参考 手册 的 “传播 性 持久 化 ” (Transitive persistence (H 


LI =p 


REI PH EIER ERN RAKETE, ERA BEEN 
集中 在 更 为 抽象 和 重要 的 任务 上 ， 所 以 在 时 机 适当 时 值得 使 用 。 这 会 
让 人 想起 Java 那 令 人 信服 的 垃圾 收集 机 制 所 带 来 的 程序 员 的 解放 ， 但 是 
也 有 一 定 的 局 限 性 ， 例 如 ， 无 法 通过 可 达 性 分 析 (reachability 


analysis) 而 明确 地 知道 什么 时 候 已 经 完成 了 数据 的 持久 化 。 你 得 调用 
delete () ， 并 建立 生命 周期 连接 ， 才 可 以 在 代码 中 指明 这 一 点 。 灵 活 
性 和 目 动 化 的 简单 性 之 间 的 得 失 征 由 你 决定 的 ， 取 决 于 数据 的 本 质 和 

项 目的 需要 。 


[1] 
http://www.hibernate.org/hib_docs/v3/reference/en/html/objectstate.html#ob 


jectstate-transitive. 
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(reflexive association) 。 这 种 关联 用 于 文 持 持 久 化 递归 结构 的 数据 ， 
例如 树 状 结构 ， 这 种 结构 中 的 和 点 之 间 会 彼此 互相 链接 。 数 据 库 表 中 
如 宁 存 储 了 这 种 关系 的 数据 ， 要 以 SQL 查询 接口 来 检索 这 些 数据 将 非 
芝 困 难 。 所 符 ， 将 这 种 关联 映射 到 Java 对 象 后 ， 处 理 束 变 得 更 容易 理 
解 和 目 然 了 。 


在 我 们 的 音乐 数据 库 中 可 能 使 用 自身 链接 (reflexive link) 的 方式 
之 一 是 让 艺人 可 以 有 替换 姓名 (alternate name) 。 这 一 功能 的 用 处 可 
能 会 超出 你 的 预期 ， 因 为 如 果 让 用 户 根据 他 们 的 思维 方式 来 决定 查 
找 "The Smiths" 或 "Smiths, The"， 有 了 替换 姓名 就 容易 多 了 ， 只 要 一 点 
点 程序 代码 ， 而 且 实 现 方式 与 编程 语言 无 关 。 


注意 ， 我 是 指 人 类 语言 ， 英 语 、 西 班 牙 语 或 其 他 语言 。 在 数据 中 
放 入 这 类 链接 ， 而 不 是 试图 去 编写 难以 理解 的 程序 代码 来 猜测 何 时 应 
该 调换 亏 人 的 姓名 。 


应 该 怎么 做 


需要 做 的 事 就 是 在 Artist.hbm.xml 里 为 Artist 有 映射 新 增 另 一 个 字段 ， 
以 建立 一 个 指向 Artist 的 链接 。 例 5-14 演 示 了 一 种 配置 方法 。 


例 5-14: 在 Artist 类 中 建立 自身 关联 


<many-to-one 

name="actualArtist"class="com.oreilly.hh.data.Artist"> 
<meta attribute="use-in-tostring">true</meta> 
</many -to-one> 


这 个 示例 配置 了 一 个 actualArtist 属 性 ， 在 建立 一 个 艺人 的 替换 姓 
名 时 ， 我 们 可 以 将 其 设置 为 “实质 的 ”Artist 记 录 的 id 值 。 例 如 ，"The 
Smiths" 记 录 的 id 值 可 能 是 5， 而 它 的 actualArtist 字 段 应 该 是 null， 因 为 
这 个 记录 是 实质 的 艺人 记录 。 然 后， 我 们 随时 都 可 以 用 "Smiths， 
The" 这 样 的 姓名 创建 “别名 ”Artist 记 录 ， 并 将 这 个 别名 记录 里 的 
actualArtist 字 段 设置 为 5， 以 指向 实质 的 记录 。 


有 时 ， 作 为 外 键 的 字段 不 能 按照 其 链接 到 的 主键 字段 的 名 称 来 命 
名 ， 目 号 链接 丈 是 这 样 的 一 个 例子 。 我 们 将 ARTIST 表 中 的 一 行 数 据 关 
联 到 ARTIST 表 中 的 另 一 行 ， 当 然 ， 数 据 表 中 已 经 有 名 为 ARTIST_ID 的 
字段 了 。 


为 什么 要 将 这 种 关联 设置 为 多 对 一 (many-to-one) 类 型 的 ? 也 许 
会 有 很 多 别名 记录 会 指向 某 个 特定 的 实质 Artist 记 录 。 所 以 ， 每 个 别名 


记录 都 必须 保存 实际 艺人 记录 的 id， 才 能 视 其 为 奉 换 姓名 。 用 数据 建 
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查找 艺人 的 代码 只 需要 在 返回 前 检查 actualArtist 属 性 。 如 果 是 
null, 一切 都 没有 问题 ， 否 则 ， 束 应 该 返回 actualArtist 属 性 指向 的 记 
录 。 例 5-15 扩 展 了 CreateTest 中 的 getArtist () 方法 ， 以 支持 这 种 新 功 
能 (新 增 处 以 粗 体 字 表示 ) 。 注 意 ，Artist 构 造 画 数 多 了 一 个 用 于 设置 
actualArtist 的 新 参数 ， 所 以 ， 即 使 我 们 不 用 显示 替换 姓名 ， 也 得 更 新 
CreateTest 中 其 他 调用 这 个 构造 画 数 的 各 个 地 方 。 


例 5-15: 文 持 蔡 换 姓名 解析 的 艺人 得 询 方法 


public static Artist getArtist (String name, boolean create, 
Session session) { 

Query query=session.getNamedQuery 

("com.oreilly.hh.artistByName") ; 

query.setString ("name", name) ; 

Artist found= (Artist) query.uniqueResult () ; 

if (found==null&&create) { 

found=new Artist (name, new HashSet () , null) ; 

session.save (found) ; 


if (found! =null&&found.getActualArtist () ! =null) { 
return found.getActualArtist () 


return found; 


希望 这 一 章 能 让 你 感受 到 Hibernate 中 关联 和 集合 的 丰富 而 强大 的 
功能 。 很 明显 ， 你 可 以 结合 这 些 功能 ， 层 层 骨 套 ， 当 中 的 变化 之 多 ， 
念 怕 我 们 难以 在 像 这 样 的 一 本 书 中 解释 清楚 。 


好 消 恩 是 Hibernate 似 乎 已 经 相当 完善 ， 足 以 应 付 实际 应 用 中 可 能 
会 遇 到 的 各 种 关联 关系 ， 甚 至 为 你 完成 建立 数据 类 和 数据 库 模 式 ， 这 
样 辛 藻 索 重 的 工作 。 当 我 开始 创建 这 些 示 例 时 ，Hibernate 工 作 的 有 效 
性 和 深远 性 远 远 超过 了 我 的 预期 。 


第 6 章 ” 目 定义 值 类 型 


用 户 目 定义 类 型 


由 附录 A 可 见 ，Hibernate 文 持 很 多 Java 类 型 〈 既 有 简单 的 值 类 型 ， 
也 有 对 象 类 型 ) 。 通 过 建立 映射 规范 ， 甚 至 可 以 将 非常 复杂 的 、 航 套 
的 对 象 结构 持久 化 保存 到 任何 数据 表 和 字段 内 。 既 然 Hibernate 提 供 的 
功能 强大 而 又 灵活 ， 你 可 能 会 问 为 什么 Hibernate 内 建 的 类 型 文 持 还 会 
不 够 用 ? 


促使 你 使 用 Hibernate 自 定义 类 型 的 一 种 情况 是 ， 你 想 使 用 不 同 于 
Hibernate 通 常情 况 下 会 选择 的 SQL 字段 类 型 来 保存 某 种 特定 的 Java 类 
型 。Hibernate 参 考 文档 引用 了 一 个 例子 ， 它 将 Java BigInteger 类 型 的 值 
持久 化 保存 到 VARCHAR 字 段 。 在 某 些 为 了 兼容 于 传统 数据 库 (legacy 
database) 模式 的 情况 下 ， 就 可 能 需要 这 么 做 。 


男 一 种 常见 的 目 定 义 类 型 使 用 场合 涉及 枚 举 类 型 值 的 持久 化 。 在 
Java 5 以 前 ， 没 有 为 枚 举 类 型 提供 内 建 的 语言 文 持 。 所 以 ， 尽 管 Joshua 
Bloch 在 他 的 《Effective Java Programming Language Guide) (Addison- 
Wesley) 一 书 中 提出 的 优秀 的 设计 模式 是 事实 上 的 标准 ， 但 Hibernate 
还 是 不 知 应 该 如 何 支 持 这 一 概念 。 在 Hibernate 3 之 前 ，Hibernate 就 提 


供 了 PersistentEnum 接 口 ， 但 这 一 接口 与 Java 5 中 引入 的 原生 (native) 
枚 举 类 型 (enum) 的 支持 并 不 适合 ， 所 以 PersistentEnum 对 于 Java 5 的 
enum 类 型 也 没有 什么 用 途 。 而 且 不 笠 的 是 ，Hibernate 现 在 还 没有 提供 
相应 的 替换 解决 办 法 ， 所 以 我 们 在 这 里 将 介绍 如 何 利用 Hibernate 对 目 
定义 类 型 的 支持 来 实现 枚 举 类 型 的 持久 化 。 


男 一 种 需要 调整 类 型 系统 的 场合 是 ， 你 必须 将 一 个 属性 值 拆 分 成 
多 个 组 成 分 部 ， 并 保存 到 多 个 数据 库 字 段 。 也 许 ， 公 司 内 部 强制 要 来 
使 用 的 可 重用 库 中 的 Address 对 象 是 把 ZIP+4 码 保存 成 了 一 个 单独 的 字 
符 串 ， 但 是 你 要 整合 的 数据 库 却 需要 一 个 5 位 数字 的 字段 和 一 个 4 位 数 
字 、 其 值 可 为 null 的 字段 ， 来 保存 这 两 部 分 的 数据 。 或 者 ， 也 有 可 能 
征 相 反 的 情况 ， 需 要 将 一 个 数据 库 字 段 拆 分 成 多 个 属性 。 


所 幸 ， 像 这 种 情况 ，Hibernate 可 以 让 你 控制 持久 化 映射 的 细节 ， 
使 你 在 不 得 已 时 也 能 找到 一 种 权宜 之 计 。 


注意 ， 让 简单 的 事情 更 容易 ， 复 杂 的 事情 有 可 能 。 这 样 的 精神 要 
寺 续 下 去 。 


印 使 在 菏 些 不 是 严格 必需 的 情况 下 ， 你 也 可 能 会 想 建立 目 定义 值 
类 型 。 如 果 你 有 一 个 复合 类 型 (composite type) ， 它 在 整个 应 用 程序 
中 的 许多 地 方 都 用 得 到 (向 量 、 复 数 、 地 址 等 ，， 你 当然 可 以 把 会 用 
到 它 的 地 方 都 映射 成 组 件 。 但 古 ， 将 映 味 细 市 封 流 在 一 个 可 共 至 的 、 


可 重用 的 Java 类 内 ， 比 让 映 冉 细 届 在 每 个 映射 文档 内 到 处 传播 可 能 
有 价值 。 如 此 一 来 ， 如 采 映 冉 细 市 因 任 何 原因 需要 修改 时 ， 只 需要 修 
改 一 个 类 ， 而 不 用 去 寻找 和 调整 众多 特定 组 件 的 映射 配置 。 


就 上 述 所 有 使 用 场合 而 言 ， 所 需要 做 的 任务 就 是 告诉 Hibernate 一 
种 新 方法 ， 让 它 知 道 如 何 对 内 存 中 特定 类 型 的 值 及 其 数据 库 持久 化 保 
存 形式 做 相互 转化 。 


应 该 怎么 做 


Hibernate 能 让 你 在 需要 的 情况 下 目 行 提供 映射 值 的 逻辑 ， 办 法 束 
是 实现 以 下 两 个 接口 之 一 : org.hibernate.usertype.UserType 或 


org.hibernate.usertype.CompositeUserType ° 


Hibernate 会 为 特定 类 型 的 值 创建 一 个 转化 器 (translator) ， 而 并 
非 为 它 另 外 创建 一 种 知道 如 何 目 行 持久 化 的 新 类 型 的 值 ， 了 解 这 一 点 
很 重要 。 换 言 之 ， 以 ZIP 码 为 例 ， 不 是 由 ZIP 码 属性 本 吴 去 实现 
UserType 接 口 ， 而 是 我 们 要 另外 新建 一 个 实现 了 UserType 接 口 的 类 ， 
然后 在 映 喘 文 档 中 将 这 个 类 指定 为 用 于 映 喘 ZIP 码 属性 的 Java 类 型 。 
此 ， 我 认为 “ 目 定义 类 型 "这 个 术语 有 些 令 人 混 消 。 


我 们 来 看 一 个 具体 的 示例 。 如 前 所 述 ， 目 定义 类 型 的 一 个 第 见 目 
标 就 是 持久 化 枚 举 类 型 。 虽 然 Hibernate 本 身 没 有 提供 对 枚 举 类 型 的 支 


持 ， 但 是 利用 UserType 机 制 可 以 容易 地 达到 这 一 目的 。 之 后 ， 我 们 还 
会 介绍 一 个 更 复杂 的 映射 例子 ， 它 涉及 多 个 属性 和 字段 之 间 的 映射 。 


定义 一 个 持久 化 的 枚 举 类 型 


枚 举 类 型 (enumerated type) 是 程序 设计 当中 常见 而 且 有 用 的 抽 
象 ， 可 以 让 你 从 一 组 固定 的 命名 选项 中 选取 其 值 。 枚 举 类 型 最 初 在 
Pascal 中 的 表达 形式 相当 不 错 ， 但 C 语 言 只 实现 了 最 基本 的 枚 举 类 型 
(基本 上 只 能 把 符号 名 称 指 定 给 某 些 可 交换 的 整数 值 ) ， 结 果 早 期 的 
Java 版 本 只 保留 了 C 语 言 的 enum 关 键 字 ， 却 一 直 没 有 实现 它 。 一 种 名 
为 “类 型 安全 的 枚 举 模 式 ”(typesafe enum pattern) 的 面向 对 象 的 优秀 
方法 逐步 形成 ， 并 通过 Joshua Bloch 写 的 《Effective Java》 一 书 而 大 受 
欢迎 。 这 种 枚 举 模式 方法 需要 编写 一 大 堆 模 板式 的 代码 ， 但 能 够 让 你 
做 各 种 有 趣 而 且 功 能 强大 的 事情 。 而 Java 5 规范 带 来 的 众多 令 人 振奋 的 
创新 之 一 就 是 让 enum 关 键 字 再 度 复 活 ， 这 是 一 种 获得 类 型 安全 的 枚 举 
功能 的 简单 方法 ， 并 且 不 需要 编写 党 琐 的 模板 代码 。 此 外 ， 还 提供 了 
其 他 好 处 。 


TER: C 语 言 风 格 的 数字 型 的 枚 举 类 型 还 是 在 Java 中 时 和 常 出 现 。 
Sun API 中 旧 的 部 分 束 有 很 多 。 


不 论 枚 举 类 型 是 用 什么 方法 实现 的 ， 偶 尔 会 需要 将 这 种 值 持久 化 
保存 到 数据 库 。 虽 然 现在 Java 中 已 经 有 了 标准 的 枚 举 类 型 ， 但 


Hibernate 并 没有 提供 内 建 的 支持 。 所 以 我 们 来 看 看 如 何 用 Hibernate 的 
UserType 接 口 来 实现 枚 举 值 的 持久 化 。 


假设 我 们 想 要 能 够 指明 曲目 来 自 何 处 ， 例 如 录音 市 、Vinyl、VHS 
影 沉 、CD、 广 播 、Internet 下 载 网 站 以 及 数字 首 频 流 。 (我 们 需要 区 分 
从 Internet 网 站 下 载 ， 还 是 从 像 Sirius 或 XM 这 类 卫星 无 线 电 服 务 下 载 ， 
或 者 区 分 是 从 无 线 电 台 还 是 从 电视 台 下 载 。 这 实在 会 让 人 发 狗 ， 不 
过 ， 用 来 说 明 这 个 重要 概念 倒是 很 适合 的 。) 

不 考虑 持久 化 ， 类 型 安全 的 枚 举 类 看 起 来 可 能 类 似 于 例 6-1 (已 经 


对 JavaDoc 进 行 了 压缩 ， 以 节约 印刷 空间 。 但 是 ， 如 果 从 网 站 下 载 的 
话 ， 格 式 是 完整 的 ) 。 


例 6-1: SourceMedia.java (第 一 个 类 型 安全 的 枚 举 类 ) 


package com.oreilly.hh; 

JER 

*This is a typesafe enumeration that identifies the media on 
which an 

*item in our music database was obtained. 

*/ 

public enum SourceMedia{ 

/**Music obtained from magnetic cassette tape.*/ 

CASSETTE ("Audio Cassette Tape") , 

/**Music obtained from a vinyl record.*/ 

VINYL ("Vinyl Record") ， 

/**Music obtained from VHS tapes.*/ 

VHS ("VHS Videocassette tape") , 

/**Music obtained from a broadcast. */ 

BROADCAST ("Analog Broadcast") , 

/**Music obtained from a digital compact disc.*/ 

CD ("Compact Disc") , 

/**Music obtained as an Internet download. */ 


DOWNLOAD ("Internet Download") , 

/**Music obtained from a digital audio stream.*/ 

STREAM ("Digital Audio Stream") ; 

/** 

*Stores the human-readable description of this instance, by 
which it is 

*identified in the user interface. 

*/ 

private final String description; 

JER 

*Enum constructors are always private since they can only be 
accessed 

*through the enumeration mechanism. 

* 

*@param description human readable description of the source for 
the 

*audio, by which it is presented in the user interface. 

*/ 

private SourceMedia (String description) { 

this .description=description; 


} 

JER 

*Return the description associated with this enumeration 
instance. 

* 


*@return the human-readable description by which this value is 
*identified in the user interface. 

RR 

public String getDescription () { 

return description; 


} 
} 


当然 ， 使 用 Hibernate 的 妙 处 就 是 我 们 不 需要 修改 通 币 的 Java 类 ， 
就 可 以 增加 持久 化 文 择 。 即 使 我 们 原来 在 设计 这 一 enum 类 型 时 还 没有 
考虑 持久 化 ， 我 们 以 后 也 是 照 原 样 使 用 这 个 类 型 。 由 于 现在 不 必 考 虑 
使 用 过 时 的 PersistentEnum 接 口 ， 那 么 定义 一 个 可 持久 化 的 枚 举 类 型 与 
定义 其 他 任意 枚 举 类 型 束 没 有 什么 区 别 了 。 


注意 : 使 用 PersistentEnum 接 口 需要 修改 欲 持久 化 的 枚 举 类 型 的 定 
义 。 与 PersistentEnum 接 口 不 符合 《Effective Java》 提 出 的 可 持久 化 枚 
举 模 式 或 Java 5 enum 关 键 字 相 比 ， 这 可 能 是 废除 PersistentEnum 接 口 的 
更 大 原因 。 


那么 如 何 告 诉 Hibernate 持 久 化 保存 我 们 的 枚 举 类 型 的 值 呢 ? 接 下 


来 就 介绍 这 些 。 


fE H E EPRE 


如 本 章 介绍 部 分 所 述 ， 我 们 打算 创建 一 个 枚 举 类 ， 而 且 可 以 用 
Hibernate 对 它 的 值 进行 持久 化 。 我 们 将 这 个 新 类 命名 为 
SourceMediaType。 接 下 来 再 决定 它 需要 实现 UserType 接 口 ， 还 是 
CompositeUserType 接 口 。Hibernate 参 考 文档 对 此 问题 没有 提供 什么 指 
导 ， 但 API 文 档 对 这 两 个 接口 名 称 所 隐 仿 的 意义 做 了 确认 : 只 有 在 自 
定义 类 的 实现 想 以 命名 属性 的 形式 来 暴露 其 内 部 结构 ， 使 其 能 在 查询 
中 被 单独 访问 时 (例如 ZIP 码 的 例子 ) ， 才 需要 使 用 
CompositeUserType 接 口 。 对 于 SourceMedia， 实 现 简单 的 UserType 就 够 
用 了 。 例 6-2 演 示 了 符合 我 们 需要 的 映射 管理 器 (1) (mapping 
manager) 的 源 代码 。 


例 6-2: 自 定义 类 型 映射 处 理 器 (SourceMediaType.java) 


package com.oreilly.hh; 

import java.io.Serializable; 

import java.sql.PreparedStatement; 

import java.sql.ResultSet; 

import java.sql.SQLException; 

import java.sql.Types; 

import org.hibernate.Hibernate; 

import org.hibernate.HibernateException; 

import org.hibernate.usertype.UserType; 

JEX 

*Manages persistence for the{@link SourceMedia}typesafe 
enumeration. 

*f 

public class SourceMediaType implements UserType{ 


/** 

*Indicates whether objects managed by this type are mutable. 

* 

*@return<code>false</code>, since enumeration instances are 
immutable 

*singletons. 

*/ 

public boolean isMutable () { 

return false; 

Ve 

*Return a deep copy of the persistent state, stopping at 

*entities and collections. 

* 

*@param value the object whose state is to be copied. 

*@return the same object, since enumeration instances are 
singletons. 

wy 

public Object deepCopy (Object value) { 

return value; 

J 

*Compare two instances of the class mapped by this type for 
persistence 

*"equality". 

* 

*@param x first object to be compared. 

*@param y second object to be compared. 

*@return<code>true</code>iff both represent the same 
SourceMedia type. 

*@throws ClassCastException if x or y isn't a{@link 
SourceMedia}. 

wd 

public boolean equals (Object x, Object y) { 

//We can compare instances, since SourceMedia are immutable 
singletons 

return (x==y) ; 

a 

*Determine the class that is returned by{@link#nullSafeGet}. 

* 

*@return{@link SourceMedia}, the actual type returned 

*by{@link#nullSafeGet}. 

*/ 

public Class returnedClass () { 

return SourceMedia.class; 


} 
/** 


*Determine the SQL type (s) of the column (s) used by this type 
mapping. 


*@return a single VARCHAR column. 

*/ 

public int[]sqlTypes () {0 

//Allocate a new array each time to protect against callers 
changing 

//its contents. 

int[]typeList=new int[1]; 

typeList[0]=Types .VARCHAR; 

return typeList; 

} 

[** 

*Retrieve an instance of the mapped class from a JDBC{@link 
ResultSet}. 

* 


*@param rs the results from which the instance should be 
retrieved. 

*@param names the columns from which the instance should be 
retrieved. 

*@param owner the entity containing the value being retrieved. 

*@return the retrieved{@link SourceMedia}value, or<code>null 
</code>. 

*@throws SQLException if there is a problem accessing the 
database. 

*/ 

public Object nullSafeGet (ResultSet rs, String[]names, Object 
owner) 

throws SQLException® 

{ 

//Start by looking up the value name 

String name= (String) Hibernate.STRING.nullSafeGet (rs, 
names[0]) ; 

if (name==null) { 

return null; 


//Then find the corresponding enumeration value 


try{ 
return SourceMedia.valueOf (name) ; © 


} 
catch (IllegalArgumentException e) { 


throw new HibernateException ("Bad SourceMedia value: "+name, 


*Write an instance of the mapped class to a{@link 
PreparedStatement}, 

*handling null values. 

* 

*@param st a JDBC prepared statement. 

*@param value the SourceMedia value to write. 

*@param index the parameter index within the prepared statement 
at which 

* 

this value is to be written. 

*@throws SQLException if there is a problem accessing the 
database. 

*/ 

public void nullSafeSet (PreparedStatement st, Object value, int 
index) 

throws SQLException® 

{ 

String name=null; 

if (value! =nul11) 

name= ( (SourceMedia) value) .toString () ; 

Hibernate.STRING.nullSafeSet (st, name, index) ; 

} 

JEX 

*Reconstruct an object from the cacheable representation.At the 
very least this 

*method should perform a deep copy if the type is mutable. 

(optional operation) 
* 


*@param cached the object to be cached 

*@param owner the owner of the cached object 

*@return a reconstructed object from the cachable representation 

yh 

public Object assemble (Serializable cached, Object owner) { 

return cached; 

D 

*Transform the object into its cacheable representation.At the 
very least this 

*method should perform a deep copy if the type is mutable.That 
may not be enough 

*for some implementations, however; for example, associations 
must be cached as 

*identifier values. (optional operation) 

* 

*@param value the object to be cached 

*@return a cachable representation of the object 

ay: 

public Serializable disassemble (Object value) { 


return (Serializable) value; 

} 

JER 

*Get a hashcode for an instance, consistent with 
persistence"equality". 

*@param x the instance whose hashcode is desired. 

*/ 

public int hashCode (Object x) { 

return x.hashCode () ; 

} 

JER 

*During merge, replace the existing (target) value in the entity 
we are merging to 

*with a new (original) value from the detached entity we are 
merging.For immutable 

*objects, or null values, it is safe to simply return the first 
parameter . For 

*mutable objects, it is safe to return a copy of the first 
parameter.For objects 

*with component values, it might make sense to recursively 
replace component values. 

* 


*@param original the value from the detached entity being merged 

*@param target the value in the managed entity 

*@return the value to be merged 

*/ 

public Object replace (Object original, Object target, Object 
owner) 

throws HibernateException 

{ 

return original; 

} 

} 


这 么 长 的 一 大 段 代 码 看 起 来 有 些 令 人 晨 惧 ， 不 过 ， 不 要 担心 。 这 
个 类 中 的 所 有 方法 都 是 由 UserType 接 口 指定 的 。 我 们 的 实现 相当 简洁 
了 明了， 刚好 符合 我 们 所 做 的 简单 映射 的 需要 。 前 三 个 方法 没什么 可 讨 
论 的 ， 看 看 JavaDoc 和 代码 内 藤 的 注释 惑 够 了 ， 以 下 是 对 代码 中 一 些 有 
意思 的 地 方 进行 的 注释 : 


@sqlTypes () 方法 癌 Hibernate 报 告 该 自 定 义 类 型 需要 保存 其 值 的 
列 的 数量 ， 以 及 这 些 列 的 SQL 类 型 。 这 里 我 们 的 类 型 使 用 一 个 


VARCHAR 类 型 的 列 。 


因为 API 规 定 必须 将 这 种 信息 作为 数组 返回 ， 安 全 的 编码 实践 要 
求 在 每 次 调用 时 都 创建 和 返回 一 个 新 的 数组 ， 以 防止 恶意 代码 或 错误 
代码 可 能 操纵 该 数组 的 内 容 (Java 不 支持 不 可 变数 组 。 如 果 UserType 
接口 声明 这 个 方法 返回 Collection 或 List 就 好 了 ， 因 为 这 些 类 型 可 以 是 
不 可 变 的 ) 


@ 在 nullSateGet O 中 ， 我 们 将 数据 结果 转换 为 相应 的 
MediaSource 枚 举 值 。 因 为 我 们 知道 这 个 值 在 数据 库 中 保存 为 字符 串 ， 
所 以 能 够 将 实际 的 查询 过 程 委 托 给 Hibernate 的 工具 方法 ， 让 它 从 数据 
库 结 采 中 加 载 字 符 串 。 在 大 多 数 情况 下 ， 都 能 够 做 这 样 的 处 理 。 


日 接着 只 需要 使 用 枚 举 类 型 目 己 的 实例 查询 功 能。 


@HibernateException 是 当 执 行 映 射 操 作 发 生 问 题 时 ，Hibernate 抛 
出 的 一 个 Runtime-Exception。 我 们 这 里 “借用 ”了 现成 的 Hibernate 异 
常 ， 因 为 可 以 认为 问题 与 映射 相关 。 如 宁 我 们 想 搞 得 人 花哨 些 ， 可 以 通 
过 定义 自己 的 异常 类 型 来 提供 更 多 的 细节 ， 不 过 最 好 让 上 自 定 义 的 异常 
类 扩展 HibernateException， 尤 其 是 在 像 Spring 这 样 的 抽象 框架 中 使 用 
时 ， 这 样 做 更 有 意义 (我 们 将 在 第 13 章 介绍 Spring) e 


日 另 一 个 方向 的 映射 是 由 nullSafeSet O) 处 理 的 。 我 们 再 一 次 依靠 
Java 与 内 建 的 enum 机 制 将 SourceMedia 实 例 转 换 为 相应 的 名 称 ， 接 着 使 
用 Hibernate 工 具 将 这 个 字符 串 保 存 到 数据 库 中 。 


在 所 有 对 值 进行 处 理 的 方法 中 ， 很 重要 的 一 点 就 是 编写 代码 的 方 
法 ， 如 果 任 何 一 个 参数 为 null 时 〈 这 种 情况 经 常 发 生 ) ， 方 法 执行 不 
会 朋 溃 。 方 法 名 称 前 的 "nullSafe" 前 组 就 是 对 此 的 一 种 提 柄 ， 不 过 ， 即 
使 是 equals () 方法 也 必须 谍 慎 使 用 。 盲 目地 使 用 x.equals (y) ， 当 x 
为 null 时 ， 就 会 让 程序 甬 误 。 


其 他 方法 是 一 些 普通 的 接口 方法 的 实现 ， 因 为 在 处 理 不 可 变 的 单 
例 对 象 (immutable singleton) 时 ， 虽 然 是 枚 举 值 ， 也 应 该 避免 在 持久 
化 管理 时 潜在 的 复杂 性 。 


好 吧 ， 我 们 已 经 创建 了 一 个 目 定义 的 类 型 持久 化 处 理 大 ， 它 并 没 
有 想象 中 的 那么 难 。 接 下 来 就 可 以 真正 用 它 来 持久 化 我 们 的 枚 举 数据 
fe 


DAE A fi 


IRE ce fel EIS A tet ° ÆA TEX ` SourceMedia ` FAKE 
理 研 和 SourceMediaType 以 后 ， 需 要 做 的 束 是 修改 以 前 的 映射 文档 ， 在 


需要 映 喘 的 地 方 ， 使 用 我 们 目 定义 的 持久 化 管理 万 类 而 不 是 原先 的 原 


台 值 类 型 (raw value type) ° 


我 们 将 通过 一 个 例子 ， 用 媒体 来 源 枚 举 类 型 来 演示 它 的 持久 化 。 
但 古 在 深入 这 个 例子 以 前 ， 我 们 先 舟 候 片刻 ， 考 虑 一 下 如 何 让 实现 变 
得 更 加 通用 ， 以 便 在 更 大 的 项 目 中 使 用 。 


其 他 


如 采 需 要 持久 化 保存 多 个 枚 举 类 型 呢 ? 如 采 你 曾经 考虑 过 这 个 问 
题 ， 你 可 能 会 认为 这 与 例 6-2 在 本 质 上 没有 什么 不 同 ， 只 不 过 例 6-2 只 
专注 于 持久 化 我 们 的 SourceMedia 枚 举 类 型 。 代 码 中 涉及 类 型 的 位 置 只 
AJLA 〈 如 果 忽 略 JavaDoc， 甚 至 要 更 少 ) 。 为 什么 不 能 将 枚 举 类 型 参 
数 化 ， 在 一 个 单独 的 实现 中 束 可 以 支持 任何 枚 举 类 型 ， 这 样 做 不 是 更 
简单 吗 ? 


确实 ， 这 样 做 会 相当 简单 ， 如 果 Hibernate 要 是 内 建 了 一 种 这 样 简 
单 而 灵活 的 机 制 ， 那 就 更 好 了 。 在 Hibernate 维 基 (wiki) 上 还 有 几 种 
可 供 选 择 的 方法 (在 几 个 不 同 的 页 面 上 ， 可 能 需要 按 主题 类 型 浏 
览 ) ， 或 许 我 们 应 该 采用 Gavin King 提 出 的 Enhanced UserType (改进 
版 的 UserType) ” (在 Java 5 EnumUserType ('*!) 主题 页 ， 来 作为 我 
们 非 官方 的 “官方 选择 ”(afficial choice) ， 因 为 他 是 Hibernate 诸 多 作者 


之 一 。 这 种 方法 的 功能 看 起 来 已 经 相当 完整 了 ， 只 是 还 没有 轻率 地 付 
诸 实 用 。 不 过 ， 现 在 至 少 可 以 考虑 一 下 将 它 与 例 6-2 进 行 比较 ， 看 看 在 
让 我 们 的 解决 方案 更 为 通用 化 方面 还 能 做 哪些 工作 。 


注意 ， 我 可 以 听 到 很 多 感慨 "到 时 间 了 ”， 


但 站 现在， 继续 我 们 具体 的 示例 ， 看 看 怎么 样 真 正 使 用 我 们 的 枚 


举 失 型 


[1] 这里， 原文 中 使 用 了 映射 管理 器 (mapping manager) LAR BE 
类 型 映射 处 理 器 (custom type mapping handler) 这 两 个 不 同 的 词 ， 容 
易 让 读者 产生 混淆 。 事 实 上 ， 它 们 都 是 指 同样 的 概念 。 

[2] http://www.hibernate.org/272.html. 


使 用 持久 化 的 枚 举 对 象 


你 可 能 已 经 注意 到 ， 本 章 一 开始 并 没有 为 SourceMedia 类 定义 持久 
化 映射 。 这 是 因为 枚 举 类 型 是 一 个 值 ， 只 能 将 它 作为 一 个 或 多 个 实体 
的 一 部 分 而 进行 持久 化 保存 ， 而 不 是 目 成 一 个 实体 。 


办 此， 我 们 还 没有 做 任何 映射 也 束 不 奇怪 了 。 当 我 们 要 实际 使 用 
持久 化 的 枚 举 类 型 时 ， 才 需要 这 么 做 ， 这 就 是 本 世 要 介绍 的 内 容 。 


应 该 怎么 做 


回想 一 下 ， 我 们 想 在 目 动 唱片 机 系统 中 保存 音乐 曲目 的 来 源 媒 
介 。 也 就 是 说 ， 我 们 想 在 Track 映 射 配 置 中 使 用 SourceMedia 这 一 枚 举 类 
型 。 可 以 简单 地 在 Track.hbm.xml 中 的 class 定 义 内 添加 一 个 新 的 property 
标签 ， 如 例 6-3 所 示 。 


例 6-3: 在 Track 映射 文档 中 新 增 一 个 SourceMedia 属 性 


<property name="volume"type="Short" > 

<meta attribute="field-description" >How loud to play the track 
</meta> 

</property> 

<property 
name="sSourceMedia"type="com.oreilly.hh.SourceMediaType" > 

<meta attribute="field-description" >Media on which track was 
obtained</meta> 

<meta attribute="use-in-tostring">true</meta> 


</property> 
<set name="comments"table="TRACK_COMMENTS" > 


注意 ， 我 们 告诉 Hibernate， 这 个 属性 是 UserType 接 口 的 实现 类 ， 而 
不 是 它 负 责 持 久 化 的 原始 枚 举 类 型 。 因 为 SourceMedia 属 性 的 type 配 置 
了 一 个 实现 了 UserType 接 口 的 实现 类 ，Hibernate 束 会 委托 这 个 类 来 为 
sourceMedia 属 性 执行 持久 化 ， 以 及 查找 与 映射 相关 的 Java 类 和 SQL 类 


型 o 


现在 ， 运 行 ant codegen 命 令 来 更 新 Track 类 ， 以 引入 这 个 新 的 属 
性 。 


不 要 这 么 快 


在 开发 本 章 示例 期 间 ， 我 遇 到 过 一 个 奇怪 的 问题 ， 代 码 突然 不 能 
通过 编译 ， 报 告 没 有 发 现 构造 画 数 。 起 初 ， 这 个 问题 看 起 来 好 像 和 采 
用 Maven Ant Tasks 进 行 依赖 管理 有 关 ， 这 个 问题 在 我 测试 时 第 一 次 出 
现 。 仔 细 检 查 源 代码 ， 确 定 是 不 是 哪 出 问题 了 。 这 花费 了 不 少时 间 ， 
因为 这 段 代码 很 微妙 。 可 能 是 因为 Track 类 的 sourceMedia 属 性 被 赋予 了 
SourceMediaType 类 型 的 值 (映射 管理 器 ) ， 而 不 是 它 应 该 接受 的 


SourceMedia 类 型 。 


在 所 有 办 法 都 失败 以 后 ， 我 将 这 个 麻烦 的 bug 报 告 给 了 Hibernate 
Tools 团 队 ， 他 们 很 快 回复 说 不 能 重 现 那 个 问题 ， 这 时 我 明日 是 怎么 回 


事 了 。 构 建 过 程 之 所 以 中 断 是 因为 : Hibernate Tools 需 要 能 够 找到 编译 
好 的 SourceMediaType 类 ， 映 射 文档 才 有 意义 ， 也 才能 够 知道 这 个 类 是 
用 户 自 定义 的 类 型 。 在 写 这 段 文字 时 ， 我 已 经 编写 和 编译 好 了 
SourceMediaType 类 ， 这 样 ， 当 我 按 例 6-3 所 示 来 更 新 映射 配置 并 调用 
codegen 构 建 目标 时 ， 该 类 编译 好 的 类 文件 应 该 到 位 了 。 但 当 我 回头 再 
用 Maven Ant Tasks 进 行 测试 时 ， 其 实 这 时 还 没有 编译 好 的 类 存在 ， 就 
像 你 在 下 载 代 码 示例 文件 以 后 ， 再 按 本 书 革 市 介绍 的 办 法 来 更 新 创建 
和 查询 测试 。 不 过 ， 如 果 在 这 种 情况 下 ， 在 compile 之 前 运行 codegen 就 
会 让 你 处 于 一 种 类 文件 不 一 致 、 不 能 编译 的 境地 。 但 是 也 不 能 在 
codegen 之 前 运行 compile， 因 为 测试 类 的 运行 要 依赖 于 生成 的 数据 类 。 


注意 : 听 起 来 确实 有 些 像 经 典 的 catch-22 问 题 (因为 不 合 逻 辑 的 规 
定 而 造成 左右 为 难 的 困境 ) 。 


很 不 幸 ， 当 没有 很 谨慎 地 维护 构建 指令 时 ， 这 种 令 人 头痛 的 循环 
依赖 问题 并 非 不 常见 。 我 为 codegen 引 入 了 一 个 新 的 依赖 ， 但 没有 在 
build.xml 中 定义 。 因 为 我 们 查找 错误 的 方向 有 误 ， 所 以 浪费 了 很 多 时 
间 ， 但 也 正 因 为 这 样 ， 我 才 有 机 会 插 述 这 一 问题 和 它 的 解决 方案 。 所 
以 ,项 户 当 你 再 过 到 类 似 的 情况 时 ， 会 变 得 更 聪明 些 。 


在 清楚 地 理解 了 问题 出 在 哪 以 后 ， 就 不 难 解决 了 。 例 6-4 展 示 了 需 
要 对 build.xml 做 的 修改 。 


例 6-4: 在 构建 过 程 中 定义 UserType 类 的 依赖 


<! --Compile the UserType definitions so they can be used in the 
code 

generation phase. --> 

<target name="usertypes"depends="prepare"® 

description="Compile custom type definitions needed in by 
codegen" > 

<javac srcdir="${source.root}" 

includes="com/oreilly/hh/*Type. java" 

destdir="${class.root}" 

debug="on" 

optimize="off" 

deprecation="on" > 

<classpath refid="project.class.path"/> 

</javac> 

</target> 

<! --Generate the java code for all mapping files in our source 
tree--> 

<target name="codegen"depends="usertypes"@® 

description="Generate Java source from the O/R mapping files" > 


@ 我 们 在 现 有 的 codegen 目 标 之 前 ， 创 建 了 一 个 名 为 usertypes 的 构 
建 目 标 ， 用 于 编译 刚才 的 用 户 类 型 定义 。 因 为 自 定义 类 型 不 会 引用 任 
何 生成 的 类 ， 所 以 可 以 在 codegen 目 标 运 行 之 前 先 编译 它们 。 选 择 这 些 
目 定 义 类 型 的 最 简单 的 方法 ， 就 是 利用 它们 位 于 com.oreillyhh 包 这 一 事 
实 ， 以 及 我 们 在 这 里 使 用 的 命名 惯例 《Hibernate 本 身 也 将 这 个 包 作为 
它 保 存 类 型 映射 类 的 地 方 ) ， 在 这 个 包 中 它们 的 类 文件 都 
以 "Type.java" 结 束 (例如 ，SourceMediaType.java， 以 及 本 章 稍 后 介绍 


的 StereoVolumeType.java) 。 


如 采 你 不 喜欢 这 样 的 惯例 ， 则 可 以 把 所 有 文件 都 列 在 这 里 ， 或 古 
将 它们 放 在 其 他 单独 的 包 中 。 这 种 命名 方法 碰巧 很 适合 我 们 的 需 


@ 接 着 ， 我 们 更 新 codegen 构 建 目标 ， 让 它 依赖 usertypes。 这 样 可 
以 保证 代码 生成 任务 运行 以 前 ， 它 需要 的 自 定义 类 型 映射 总 能 成 功 编 
译 和 使 用 (这 里 不 需要 依赖 prepare， 因 为 现在 只 需要 依赖 usertypes) ° 


配置 好 这 些 额 外 的 设置 以 后 ， 现 在 运行 ant codegen 束 可 以 正确 地 更 
新 Track 类 ， 以 包括 新 的 属性 。 完 整 的 Track 构造 函数 现在 应 该 如 下 所 


ZN: 


public Track (String title, String filePath, Date playTime, 
Set<Artist>artists, Date added, short volume, 
SourceMedia sourceMedia, Set<String>comments) {......} 


还 需要 相应 地 修改 CreateTest.java: 


Track track=new Track ("Russian Trance", 
"yvol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") , 

new HashSet<Artist> () , 

new Date () , (short) ©, SourceMedia.CD, 

new HashSet<String> () ) ; 

track=new Track ("Video Killed the Radio Star", 
"yvol2/album611/track12.mp3", 

Time.valueOf ("00: 03: 49") , new HashSet<Artist> () , 
new Date () , (short) ©, SourceMedia. VHS, 

new HashSet<String> () ) ; 


为 了 得 到 如 图 6-1 所 示 的 结果 ， 我 们 将 "The World' 99" 标 记 为 来 自 于 
数字 首 频 流 ， 而 将 其 他 曲目 都 标记 为 来 自 CD， 而 为 "Test Tone 1" 标 记 为 
ZAJ (null) sourceMedia 值 。 这 时 ， 再 运行 ant schema 以 重建 支持 新 属 
性 的 数据 库 模 式 ， 接 着 运行 ant ctest 以 创建 样 例 数据 。 


KETTAF 


我 们 的 TRACK 表现 在 包含 了 一 个 用 于 保存 sourceMedia 属 性 的 新 字 
段 。 在 创建 好 样 例 数据 后 就 可 以 在 这 个 表 的 内 容 中 看 到 它 的 值 (最 简 
单 的 方法 就 是 用 ant db 命令 来 执行 查询 ， 结 果 如 图 6-1 所 示 ) ° 


00e HSQL Database Manager 


A jdbc:hsqidb:data/music 
E ARTET 
日 TRACK 
schema: PUBLIC 
E TRACKID | 
国 TITLE TRACEK_ID|TTLE 
@ FILEPATH Russian Trance 


PLAYTIME z 
f ADDED Video Killed the Radio Star 


E VOLUME Gravity's Angel 
图 SOURCEMEDIA Adagio for Strings (Ferry Corsten Remix) CD 
© indices Adagio for Sinngs (ATB Remix) 

TRACK _ARTETS The World "99 

B TRACK COMMENTS i Test Tone 1 

E Properties = 


图 6-1 TRACK 表 中 的 来 源 媒介 信息 


通过 交 文 检查 为 我 们 的 持久 化 枚 举 类 型 赋值 的 代码 ， 可 以 验证 持 
久 化 保存 到 数据 库 的 值 是 否 正 确 。 利 用 Java 5 的 enum 功 能 ， 甚 至 可 以 让 
这 种 原始 的 查询 显得 更 有 意义 。 


为 什么 不 能 工作 


在 为 我 们 的 映 映 文 档 引入 这 些 目 定义 类 型 的 同时 ， 也 就 在 build.xml 
引入 了 男 一 种 还 没有 反映 出 来 过 的 新 依赖 。 BREA, WR AVIV, Bt 
会 在 运行 ant shema 命 令 之 前 ， 明 到 ant 编 译 失 败 的 错误 ， 收 到 一 些 
Hibernate 报 告 的 以 下 信息 : 


[hibernatetool]INFO: Using dialect: 
org.hibernate.dialect .HSQLDialect 

[hibernatetool]An exception occurred while running exporter#2: 
hbm2dd1 

(Generates database schema) 

[hibernatetool]To get the full stack trace run ant with-verbose 

[hibernatetool]org.hibernate.MappingException: Could not 
determine type 

for: com.oreilly.hh.StereoVolumeType, for columns: 
[org.hibernate.mapping 

.Column (VOL_LEFT) , org.hibernate.mapping.Column (VOL_RIGHT) ] 

BUILD FAILED 

/Users/jim/Documents/wWork/OReilly/svn_hibernate/current/examples/ 
ch07/build 

.xml: 81: org.hibernate.MappingException: Could not determine type 
for: com 

.oreilly.hh.StereoVolumeType, for columns: 
[org.hibernate.mapping.Column 

(VOL_LEFT) , org.hibernate.mapping.Column (VOL_RIGHT) ] 

Total time: 3 seconds 


这 是 因为 ， 还 没有 编译 我 们 新 的 目 定义 类 型 ，Hibernate 不 能 发 现 
或 使 用 它们 ， 所 以 映射 起 不 到 作用 。 作 为 一 种 快速 修复 措施 ， 只 要 先 
运行 ant compile， 再 试 着 运行 ant schema 就 可 以 了 。 也 可 以 在 build.xml 
中 修复 这 个 问题 ， 这 样 以 后 就 不 会 再 麻烦 任何 人 了 了: 
en the schemas for all mapping files in our class 


<target name="schema"depends="compile" 
description="Generate DB schema from the O/R mapping files"> 


compile 构 建 目标 出 现在 schema 后 面 也 没有 什么 关系 ，Ant 会 安排 好 
它们 之 间 的 依赖 关系 。 如 果 你 觉得 不 习惯 ， 可 以 任意 交换 它们 的 位 
置 。 为 了 稳妥 起 见 ， 我 们 也 可 以 让 compile 依 赖 于 codegen， 以 确保 在 试 
图 编译 什么 以 前 ， 先 生成 数据 类 : 


<! --Compile the java source of the project--> 
<target name="compile"depends="codegen" 
description="Compiles all Java classes"> 


A TERENE, PRCA DAM ZS RCS FP aa, ae 
操作 束 完 成 所 有 的 代码 生成 和 编译 处 理 : 


%ant compile 

Buildfile: build.xml 

prepare: 

[copy]Copying 3 files to/Users/jim/svn/oreilly/hib_dev_2e/current 

/examples/ch07/classes 

usertypes: 

[javac]Compiling 2 source files 
to/Users/jim/svn/oreilly/hib_dev_2e 

/current/examples/ch07/classes 

codegen: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]i.task: hbm2java (Generates a set of.java files) 

compile: 

[javac]Compiling 8 source files 
to/Users/jim/svn/oreilly/hib_dev_2e 

/current/examples/ch07/classes 

BUILD SUCCESSFUL 

Total time: 3 seconds 


好 ， 我 们 回头 再 继续 学 习 目 定义 类 型 吧 。 


为 了 能 够 看 到 更 友好 的 提示 信息 〈 顺 便 也 测试 一 下 目 定 义 持 入 化 
辅助 工具 的 部 分 检索 功能 ，， 我 们 可 以 扩充 一 下 查询 测试 ， 让 它 为 检 
索 回 的 曲目 打印 输出 这 个 属性 关联 的 描述 。 必 要 的 修改 如 例 6-5 中 粗 体 
字 部 分 所 示 。 


例 6-5: 在 QueryTest.java 中 显示 来 源 媒介 信息 


//Print the tracks that will fit in seven minutes 

List tracks=tracksNoLongerThan (Time.valueOf ("00: 07: 00") , 
session) : 

for (ListIterator iter=tracks.listIterator () ; 

iter.hasNext () ; ) { 

Track aTrack= (Track) iter.next () : 

String mediaInfo=""; 

if (aTrack.getSourceMedia () ! =null) { 


mediaInfo=", from"+ 
aTrack.getSourceMedia () .getDescription () ; 
} 


System.out.printin ("Track: \""+aTrack.getTitle () +"\""+ 
listArtistNames (aTrack.getArtists () ) + 
aTrack.getPlayTime () +mediaInfo) ; 


增加 了 这 些 扩充 的 代码 后 ， 运 行 ant qtest， 其 输出 结果 如 例 6-6 所 
示 。 具 有 非 空 (non-null) 来 源 媒 介 值 的 曲目 后 面 会 跟着 一 个 "from"， 
之 后 显示 的 就 是 该 曲目 相应 的 媒介 描述 信息 。 


例 6-6: 方便 阅读 的 来 源 媒 介 信 息 显示 


qtest: 
[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 


[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 
from VHS Videocassette tape 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact Disc 
ava]Track: agio for rings (Ferry Corsten Remix illiam 
j Track: "Adagio for Strings (Ferry Corsten Remix) " (Willi 
Orbit, Ferry Corsten, Samuel Barber) 00: 06: 35, from Compact Disc 
ava]Track: est Tone 
[java]Track: "Test T 1"00: 00: 10 
ava]Comment: Pink noise to test equalization 
java]c t: Pink noise to test equalizati 


注意 ， 如 果 我 们 决定 在 QueryTest 中 不 自己 处 理 曲 目 属性 子 集 的 格 
式 化 输出 ， 而 是 要 依靠 Track 类 的 toString () 方法 ， 那 么 我 们 不 需要 对 
QueryTest 进 行 任何 修改 就 可 以 看 到 这 种 新 的 输出 信息 ， 虽 然 用 数据 库 
查询 我 们 已 经 看 到 了 同样 的 枚 举 名 称 列 表 的 最 简单 版 本 。 我 们 在 映射 
文档 中 规定 toString () 方法 返回 的 结果 应 该 包含 sourceMedia 属 性 值 ， 
该 方法 负责 处 理 这 个 属性 值 。 可 以 检查 生成 的 toString () 方法 的 源 代 
码 以 验证 这 一 点 ， 或 者 编写 一 段 简单 的 程序 来 看 看 toString () 方法 输 
出 的 结果 是 什么 样 的 。 当然， 一 种 很 好 的 策略 就 是 修改 
AlbumTestjava， 让 它 在 我 们 修改 Track 以 后 可 以 通过 编译 并 运行 。 最 简 
单 的 修改 就 是 在 addAlbumTrack () 方法 中 通过 便 编 码 (hard-code) 让 
每 个 曲目 都 来 自 CD， 如 例 6-7 所 示 (JavaDoc 已 经 为 这 种 只 图 简单 的 做 
去 想 好 了 理由 ) 。 


例 6-7: 修改 AlbumTest.java， 增 加 对 曲目 来 源 媒介 的 文 持 


JIR 

*Quick and dirty helper method to handle repetitive portion of 
creating 

*album tracks.A real implementation would have much more 
flexibility. 


ay: 

private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 

int positionOnDisc, Session session) { 

Track track=new Track (title, file, length, new HashSet<Artist> 


new Date () , (short) ©, SourceMedia.CD, 

new HashSet<String> () ) ; 

track.getArtists () .add (artist) ; 

//session.save (track) ; 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ) ; 


} 


修改 好 文件 以 后 ， 运 行 ant atest 命 令 ， 束 会 显示 在 Album 的 JtoString 
() 方法 中 生成 的 来 源 媒 介 信 息 : 


[java]com.oreilly.hh.data.Album@ccad9c[title='Counterfeit 
e.p.'tracks='[ 

com.oreilly.hh.data.AlbumTrack@9c0287[track='com.oreilly.hh.data. 
Track@6a21b2[ 

title='Compulsion'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@aa8eb7 

[track='com.oreilly.hh.data.Track@7fc8a0[title='In a Manner of 
Speaking'source 

Media='CD']'], 
com.oreilly.hh.data.AlbumTrack@4cadc4[track='com.oreilly.hh.da 

ta. Track@243618[title='Smile in the Crowd'sourceMedia='CD']'], 
com.oreilly.h 

h.data.AlbumTrack@5b644b[ track='com.oreilly.hh.data. Track@157e43[ 
title='Gone' 

sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@1483a0[track='com.oreilly 

.hh.data.Track@cdae24[title='Never Turn Your Back on Mother 
Earth'sourceMedia= 

"EDS Ts 
com.oreilly.hh.data.AlbumTrack@63dc28[track='com.oreilly.hh.data.Tra 

ck@ae511[title='Motherless Child'sourceMedia='CD']']]'] 


没有 做 多 少 工 作 ， 我 们 就 利用 Hibernate 扩 展 了 能 够 支持 持久 化 的 
类 型 安全 的 枚 举 类 。 在 付出 一 定 的 努力 之 后 ， 束 可 以 像 Hibernate 文 持 
的 其 他 原生 值 类 型 一 样 ， 方 便 地 对 这 些 枚 举 类 进行 持久 化 。 


如 果 以 后 不 用 写 代码 ，Hibernate 中 支持 的 原生 类 型 可 以 直接 利用 
Java 5 文 持 有 的 enum 天 健 子 ， 那 整 太 好 了 。 不 过 ， 对 此 我 并 不 抱 多 少 项 
望 ， 因 为 Java 5 问世 已 经 有 一 段 时 间 了 。 但 是， 束 各 种 评论 来 说 ， 这 是 
一 种 “温和 ” (mild) 的 方法 ，Hibernate wiki 上 还 有 其 他 可 供 选 择 的 支持 
枚 举 类 型 的 用 户 自 定义 类 型 的 实现 。 


接 下 来 ， 我 们 将 介绍 如 何 映射 更 加 复 洒 和 特殊 的 目 定 义 类 型 ， 没 
AA ata Hibernate Bes Aix A FRIRE RA EA EY SFE o 


建立 组 合 目 定 义 关 型 


回想 一 下 ， 我 们 的 Track 对 象 中 有 个 属性 ， 用 于 决定 曲目 在 播放 时 
音量 的 大 小 。 假 设 我 们 希望 目 动 唱机 系统 除了 能 控制 曲目 的 音量 以 
外 ， 也 能 够 调整 播放 曲目 时 音质 的 均衡 度 (balance) 。 为 了 实现 这 一 
点 ， 我 们 需要 为 左右 声 道 分 别 保存 音量 。 一 种 快速 的 解决 方案 就 是 编 
辑 Track 映 射 文档 ， 将 这 些 功 能 要 求 映 射 到 单独 的 属性 。 


如 果 我 们 严格 地 从 面向 对 象 架 构 的 角度 来 考虑 ， 可 能 希望 将 这 两 
个 音量 值 封装 到 一 个 StereoVolume 类 中 。 然 后 ， 再 将 这 个 类 直接 映射 到 
一 个 composite-element 元 素 ， 就 像 我 们 在 例 5-4 中 对 AlbumTrack 组 件 所 
做 的 那样 。 这 依然 相当 直截了当 。 


不 过 ， 这 种 简单 的 解决 方案 有 个 喘 操 。 系 统 中 的 其 他 地 方 可 能 
需要 StereoVolume 值 。 如 采 我 们 建立 一 种 播放 列表 机 制 ， 它 可 以 改写 曲 
目 上 默认 的 播放 克 项 ， 同 时 又 能 对 整个 专辑 的 播放 音量 进行 控制 。 突 然 
间 ， 我 们 就 得 在 好 几 个 地 方 重建 组 合 映 射 配置 ， 而 且 有 可 能 无 法 保持 
前 后 一 怪 (对 于 更 复杂 的 复合 类 型 来 说 ， 这 更 可 能 是 个 问题 ,但 现在 
只 需要 有 个 想法 就 可 以 了 ) 。Hibemate 参 考 文档 指出 ， 像 这 种 情况 ， 
使 用 一 个 自 定义 的 复合 类 (composite user type) 会 是 种 很 好 的 务实 做 


法 ， 我 也 同意 这 一 点 。 


应 该 怎么 做 


我 们 先 从 定义 StereoVolume 类 开始 做 起 。 没 有 理由 要 将 这 个 类 作为 
实体 (使 其 独立 存在 于 其 他 持久 化 对 象 以 外 ) ， 所 以 只 要 将 它 作 为 普 
通 的 (而 且 相 当 简 单 的 ) Java 对 象 来 实现 即 可 。 例 6-8 展 示 了 它 的 代 
码 。 


TER: 该 例 的 JavaDoc 经 过 精简 以 市 省 空间 。 相 信和 你 在 实际 项 目 中 
不 会 这 么 做 。 从 网 站 下 载 的 版 本 则 更 加 完整 。 


例 6-8: 一 个 用 于 表示 音量 等 级 的 值 类 (StereoVolume.java) 


package com.oreilly.hh; 

import java.io.Serializable; 

/** 

*A simple structure encapsulating a stereo volume level. 


public class StereoVolume implements Serializablef{ 
/**The minimum legal volume level.*/ 

public static final short MINIMUM=0; 

/**The maximum legal volume level. */ 

public static final short MAXIMUM=100; 

/**Stores the volume of the left channel. */ 
private short left; 

/**Stores the volume of the right channel. */ 
private short right; 

/**Default constructor sets full volume in both channels.*/ 
public StereoVolume () {@ 

this (MAXIMUM, MAXIMUM) ; 


/**Constructor that establishes specific volume levels. */ 
public StereoVolume (short left, short right) { 

setLeft (left) ; 

setRight (right) ; 


t 
/** 


*Helper method to make sure a volume value is legal. 

*@param volume the level that is being set. 

*@throws IllegalArgumentException if it is out of range. 

wh 

private void checkVolume (short volume) { 

if (volume <MINIMUM) { 

throw new IllegalArgumentException ("volume cannot be less than"+ 
MINIMUM) ; 


if (volume>MAXIMUM) { 
throw new IllegalArgumentException ("volume cannot be more than"+ 
MAXIMUM) ; 


} 


} 
/**Set the volume of the left channel. */ 


public void setLeft (short volume) {@ 
checkVolume (volume) ; 
left=volume; 


} 

/**Set the volume of the right channel.*/ 

public void setRight (short volume) { 

checkVolume (volume) ; 

right=volume; 

} 

/**Get the volume of the left channel*/ 

public short getLeft () { 

return left; } 

/**Get the volume of the right channel. */ 

public short getRight () { 

return right; } 

/**Format a readable version of the volume levels, for 
debugging. */ 

public String toString () { 

return"Volume[left="+left+", right="+right+']'; 

} 

JEX 

*Compare whether another object is equal to this one. 

*@param obj the object to be compared. 

*@return true if obj is also a StereoVolume instance, and 
represents 

*the same volume levels. 

ser 

public boolean equals (Object obj) {© 

if (obj instanceof StereoVolume) { 

StereoVolume other= (StereoVolume) obj; 

return other.getLeft () ==getLeft () && 

other.getRight () ==getRight () ; 

} 


return false; //It wasn't a StereoVolume 


} 

JEF 

*Returns a hash code value for the StereoVolume.This method must 
be 

*consistent with the{@link#equals}method. 

7 

public int hashCode () { 

return (int) getLeft () *MAXIMUM*10+getRight () ; 


} 


@ 因 为 我 们 想 用 Hibernate 持 久 化 这 个 对 象 ， 所 以 必须 提供 一 个 默认 
的 构造 函数 。 


@ 以 及 属性 访问 器 。 


四 提供 对 Java equals () 和 hashCode () 比较 的 支持 也 是 重要 的 ， 
因为 这 是 一 个 可 变 值 对 象 。 


为 了 将 这 个 类 作为 复合 类 型 进行 持久 化 保存 ， 而 非 每 次 使 用 时 都 
将 其 定义 为 散 套 的 组 全 对象， 我 们 需要 建立 一 个 复合 自 定 义 类 型 来 管 
理 它 的 持久 化 处 理 。 在 该 自 定义 类 型 中 所 需要 提供 的 大 部 分 处 理 和 我 
们 在 SourceMediaType 〈 例 6-2， 本 章 前 面 演示 的 一 个 例子 ) 中 提供 的 差 
不 多 。 所 以 这 里 只 集中 介绍 新 鲜 而 有 趣 的 内 容 。 例 6-9 演 示 了 以 复合 目 
定义 类 型 的 方式 来 持久 化 StereoVolume 类 的 一 种 方法 。 


例 6-9: 用 于 持久 化 StereoVolume 的 复合 自 定义 类 型 


(StereoVolumeType.java) 


package com.oreilly.hh; 

import java.io.Serializable; 

import java.sql.PreparedStatement; 

import java.sql.ResultSet; 

import java.sql.SQLException; 

import org.hibernate.Hibernate; 

import org.hibernate.engine.SessionImplementor; 

import org.hibernate. type. Type; 

import org.hibernate.usertype.CompositeUserType; 

SEF 

*Manages persistence for the{@link StereoVolume}composite type. 
*/ 

public class StereoVolumeType implements CompositeUserType{ 
IER 

*Get the names of the properties that make up this composite 


type, and 


*that may be used in a query involving it. 

4 

public String[]getPropertyNames () {@ 

//Allocate a new response each time, because arrays are mutable 
return new String[]{"left", "right"}; 

} 

JER 

*Get the types associated with the properties that make up this 


composite 


*type. 
* 


*@return the types of the parameters reported 


by{@link#getPropertynames}, 
* 


in the same order. 

*/ 

public Type[]getPropertyTypes () { 

return new Type[]{Hibernate.SHORT, Hibernate.SHORT}; 

} 

JER 

*Look up the value of one of the properties making up this 


composite type. 
* 


{© 


*@param component a{@link StereoVolume}instance being managed. 
*@param property the index of the desired property. 

*@return the corresponding value. 

*@see#getPropertyNames 

4 

public Object getPropertyValue (Object component, int property) 


StereoVolume volume= (StereoVolume) component; 
short result; 


switch (property) { 

case 0: 

result=volume.getLeft () ; 

break; 

case 1: 

result=volume.getRight () ; 

break; 

default: 

throw new IllegalArgumentException ("unknown 
property: "+property) ; 

} 

return new Short (result) ; 

} 

pA 

*Set the value of one of the properties making up this composite 
type. 

* 


*@param component a{@link StereoVolume}instance being managed. 

*@param property the index of the desired property. 

*@object value the new value to be established. 

*@see#getPropertyNames 

7 

public void setPropertyValue (Object component, int property, 
Object value) { 

StereoVolume volume= (StereoVolume) component; 

short newLevel= ( (Short) value) .shortValue () ; 

switch (property) { 

case 0: 

volume.setLeft (newLevel) ; 

break; 

case 1: 

volume.setRight (newLevel) ; 

break; 

default: 

throw new IllegalArgumentException ("unknown 
property: "+property) ; 

} 

} 

JER 

*Determine the class that is returned by{@link#nullSafeGet}. 


* 


*@return{@link StereoVolume}, the actual type returned by 
* 


{@link#nullSafeGet}. 

*/ 

public Class returnedClass () { 
return StereoVolume.class; 


} 


JEX 

*Compare two instances of the class mapped by this type for 
persistence 

*"equality". 

* 

*@param x first object to be compared. 

*@param y second object to be compared. 

*@return<code>true</code>iff both represent the same volume 
levels. 

*@throws ClassCastException if x or y isn't a{@link 
StereoVolume}. 

*/ 

public boolean equals (Object x, Object y) {® 

if (x==y) {//This is a trivial success 

return true; 


} 
if (x==null||y==null) {//Don't blow up if either is null! 
return false; 


//Now it's safe to delegate to the class'own sense of equality 

return ( (StereoVolume) x) .equals (y) ; 

} 

fit 

*Return a deep copy of the persistent state, stopping at entities 
and 

*collections. 

* 

*@param value the object whose state is to be copied. 

*@return a copy representing the same volume levels as the 
original. 

*@throws ClassCastException for non{@link StereoVolume}values. 

*/ 

public Object deepCopy (Object value) {0 

if (value==nu11) 

return null; 

StereoVolume volume= (StereoVolume) value; 

return new StereoVolume (volume.getLeft () , volume.getRight 

OE 

} 

JER 

*Indicates whether objects managed by this type are mutable. 

* 

*@return<code>true</code>, since{@link StereoVolume}is 
mutable. 

*/ 

public boolean isMutable () { 

return true; 


} 


SER 

*Retrieve an instance of the mapped class from a JDBC{@link 
ResultSet}. 

* 


*@param rs the results from which the instance should be 
retrieved. 

*@param names the columns from which the instance should be 
retrieved. 

*@param session an extension of the normal Hibernate session 
interface 

*that gives you much more access to the internals. 

*@param owner the entity containing the value being retrieved. 

*@return the retrieved{@link StereoVolume}value, or<code>null 
</code>. 

*@throws SQLException if there is a problem accessing the 
database. 

tf 

public Object nullSafeGet (ResultSet rs, String[]names, © 

SessionImplementor session, Object owner) 

throws SQLException{ 

Short left= (Short) Hibernate.SHORT.nullSafeGet (rs, names[0]) ; 

Short right= (Short) Hibernate.SHORT.nullSafeGet (rs, names[1]) ; 

if (left==null||right==null) { 

return null; //We don't have a specified volume for the channels 

} 

return new StereoVolume (left.shortValue () , right.shortValue 
QO); 

} 

JER 

*Write an instance of the mapped class to a{@link 
PreparedStatement}, 

*handling null values. 

* 

*@param st a JDBC prepared statement. 

*@param value the StereoVolume value to write. 

*@param index the parameter index within the prepared statement 
at which 

*this value is to be written. 

*@param session an extension of the normal Hibernate session 
interface 

*that gives you much more access to the internals. 

*@throws SQLException if there is a problem accessing the 
database. 

ap 

public void nullSafeSet (PreparedStatement st, Object value, int 
index, 

SessionImplementor session) 

throws SQLException{ 


if (value==null) { 

Hibernate.SHORT.nullSafeSet (st, null, index) ; 

Hibernate.SHORT.nullSafeSet (st, null, index+1) ; 

selsef{ 

StereoVolume vol= (StereoVolume) value; 

Hibernate.SHORT.nullSafeSet (st, new Short (vol.getLeft () ) , 
index) ; 

Hibernate.SHORT.nullSafeSet (st, new Short (vol.getRight () ) , 

index+1) ; 

} 

} 

JER 

*Reconstitute a working instance of the managed class from the 
cache. 

* 

*@param cached the serializable version that was in the cache. 

*@param session an extension of the normal Hibernate session 
interface 

*that gives you much more access to the internals. 

*@param owner the entity containing the value being retrieved. 

*@return a copy of the value as a{@link StereoVolume}instance. 

ty: 

public Object assemble (Serializable cached, SessionImplementor 
session, © 

Object owner) { 

//Our value type happens to be serializable, so we have an easy 
out. 

return deepCopy (cached) ; 

} 

PRR 

*Translate an instance of the managed class into a serializable 
form to be 

*stored in the cache. 

* 

*@param session an extension of the normal Hibernate session 
interface 

*that gives you much more access to the internals. 

*@param value the StereoVolume value to be cached. 

*@return a serializable copy of the value. 

A 

public Serializable disassemble (Object value, SessionImplementor 
session) { 

return (Serializable) deepCopy (value) 

} 

JEE 

*Get a hashcode for the instance, consistent with 
persistence"equality" 

ay 


public int hashCode (Object x) {@ 
return x.hashCode () ; //Can delegate to our well-behaved object 


} 

JEX 

*During merge, replace the existing (target) value in the entity 
we are 

*merging to with a new (original) value from the detached entity 
we are 

*merging.For immutable objects, or null values, it is safe to 
simply 

*return the first parameter.For mutable objects, it is safe to 
return a 

*copy of the first parameter .However, since composite user types 
often 

*define component values, it might make sense to recursively 
replace 

*component values in the target object. 

* 

*@param original value being merged from. 

*@param target value being merged to. 

*@param session the hibernate session into which the merge is 
happening. 

*@param owner the containing entity. 

*@return an independent value that can safely be used in the new 
context. 

er 

public Object replace (Object original, Object target, © 

SessionImplementor session, Object owner) { 

return deepCopy (original) ; 

} 

} 


@ 由 于 有 了 getPropertyNames () 和 getPropertyTypes () 方法 ， 
Hibernate 束 可 以 知道 组 成 复合 类 型 的 各 “组 成 部 分 ”。 当 编写 HQL 查 询 时 
就 可 以 使 用 这 些 值 类 型 。 在 这 个 例子 中 它们 相当 于 我 们 正在 持久 化 的 
实际 StereoVolume 类 的 属性 值 ， 但 不 是 必需 的 。 例 如 ， 我 们 可 以 借 这 
机 会 来 为 根本 不 是 为 持久 化 而 设计 的 遗留 (legacy) 类 提供 一 个 友好 的 
属性 接口 。 


@ 复 合用 户 定 义 类 型 的 虚拟 属性 和 它们 基于 的 真实 数据 之 间 转 换 
是 由 getPropertyValue () 和 setPropertyValue () 方法 提供 的 。 在 本 质 
上 ，Hibernate 只 是 给 了 我 们 一 个 想 要 管理 的 类 型 的 实例 ， 而 且 没 有 一 
点 假设 ， 它 只 是 说 “ 隆 ， 给 我 第 二 个 属性 ”， 或 者 是 说 “把 第 一 个 属性 设 
置 为 这 个 值 *。 你 可 以 看 到 如 何 用 这 种 方法 为 旧 的 或 第 三 方 代 码 增加 属 
性 接口 。 在 这 个 例子 中 ， 因 为 我 们 实际 上 不 需要 这 种 功能 ， 我 们 要 将 
属性 处 理 传 递 给 底层 的 StereoVolume 类 ， 这 里 要 跨越 的 障碍 只 是 模板 
类 。 


接 下 来 的 一 大 段 代码 由 前 面 例 6-2 中 见 过 的 方法 组 成 ， 不 过 例子 中 
的 版 本 具有 的 一 些 区 别 很 有 意思 。 大 部 分 变化 与 前 面 提 到 的 内 容 有 
关 ， 不 像 SourceMedia， 我 们 的 StereoVolume 类 是 可 变 的 ， 它 包含 了 可 
变化 的 值 。 所 以 ， 我 们 得 为 一 些 最 终 适合 的 方法 设计 出 完整 的 实现 。 


日 我 们 需要 在 equals () 中 提供 一 种 有 意义 的 方法 来 比较 实例 。 
@ 还 要 在 deepCopy () 中 实现 独立 的 实例 复制 。 


@ 实 际 的 持久 化 方法 (nullSafeGet () 和 nullSafeSet () ) 与 例 6-2 
非常 相似 ， 只 有 一 点 不 同 ， 我 们 对 此 不 需要 过 多 介绍 。 它 们 都 有 一 个 
SessionImplementor 参 数 ， 通 过 这 个 参数 可 以 访问 让 Hibernate 正 第 工作 
的 内 部 组 件 。 只 有 真正 复杂 的 持久 化 处 理 才 需要 使 用 这 个 参数 ， 这 已 
经 超出 本 书 介绍 的 范围 。 如 果 你 需要 使 用 SessionImplementor 方 法 ， 在 


实现 上 相当 有 技巧 ， 必 须 深 刻 理 解 Hibernate 的 体系 结构 。 其 实 你 正 写 
的 是 对 系统 的 扩展 ， 可 能 需要 研究 源 代码 才能 获得 必需 的 专业 知识 。 


@assemble () 和 disassemble () 方法 可 以 让 自 定义 类 型 支持 对 非 
Serializable 值 的 缓存 。 它 们 让 我 们 的 持久 化 工具 方法 有 机 会 可 以 将 任何 
重要 的 值 复制 到 另 一 个 能 够 被 序列 化 (serialized) 的 对 象 中 (使 用 任何 
必要 的 手段 ) 。 因 为 让 StereoVolume 首 先 成 为 可 序列 化 的 并 不 重要 ， 我 
们 也 不 需要 这 种 灵活 性 ， 所 以 我 们 的 实现 只 是 为 了 能 保存 在 缓存 中 复 
制 一 些 可 序列 化 的 StereoVolume 实 例 (之 所 以 要 复制 实例 ， 是 因为 我 们 
的 数据 类 是 可 变 的 ， 不 应 该 让 缓存 值 也 莫名 其 妙 地 发 生变 化 ) 。 


@hashCode () 方法 是 Hibernate 3 中 新 增加 的 方法 ， 虽 然 需要 修改 
CompositeUserType 实 现 ， 但 它 有 助 于 提高 效率 。 在 这 个 例子 中 ， 我 们 
有 一 个 对 象 已 经 实现 了 这 个 方法 ， 可 以 将 处 理 委托 给 这 个 对 象 。 但 
和 是， 再 一 次 强调 ， 如 采 我 们 正在 封 痛 一些 粳 糙 的 遗留 数据 结构 ， 束 可 


以 借 这 个 机 会 为 它们 增加 一 个 漂亮 的 Java 包 装 器 。 


@ 最 后 ，replace () 方法 是 Hibernate 3 要 求 的 另 一 个 新 方法 。 再 一 
次 ， 因 为 我 们 需要 复制 一 个 对 象 ， 可 以 用 一 种 容易 的 办 法 来 实现 。 男 
外 ， 我 们 也 可 以 手工 将 所 有 内 航 的 属性 值 从 最 初 的 对 象 复制 到 目标 对 
Ho 


注意 : 这 么 一 个 简单 的 值 类 居然 需要 做 这 么 多 的 工作 。 但 是 ， 这 
正 是 对 更 复杂 的 值 类 进行 建 模 的 好 起 点 。 


好 了 ， 这 头 “野兽 "已 经 创建 完成 ， 接 下 来 应 该 怎么 用 ? 为 了 使 用 
该 新 的 复合 类 型 ， 例 6-10 改 进 了 Track 映 射 文 档 中 volume 属 性 的 配置 
同时 为 了 便于 查看 测试 的 输出 ， 也 趁 此 机 会 将 它 加 到 了 toSting () 方 
法 中 。 


例 6-10: 修改 Track.hbm.xml 以 使 用 StereoVolume 


<property name="volume"type="com.oreilly.hh.StereoVolumeType" > 

<meta attribute="field-description" >How loud to play the track 
</meta> 

<meta attribute="use-in-tostring">true</meta> 

<column name="VOL_LEFT"/> 

<column name="VOL_RIGHT"/ > 

</property> 


再 次 注意 ， 映 射 文档 中 提供 的 是 负责 管理 持久 化 的 自 定 义 类 型 的 
名 称 ， 而 不 是 它 所 管理 的 原始 类 型 。 这 与 例 6-3 是 一 样 的 。 此 外 ， 这 个 
复合 类 型 使 用 两 个 字段 存储 数据 ， 所 以 这 里 也 得 提供 两 个 字段 名 称 。 


现在 ， 当 我 们 执行 ant codegen 命 令 ， 为 Track 重新 生成 Java 源 代码 
时 ， 可 以 得 到 例 6-11 所 示 的 结 


例 6-11: 新 生成 的 Track.java 源 代码 的 变动 之 处 


*How loud to play the track 

*/ 

private StereoVolume volume; 

public Track (String title, String filePath, Date playTime, 
Set<Artist>artists, Date added, 

StereoVolume volume, SourceMedia sourceMedia, 
Set<String>comments) { 


a 
*How loud to play the track 

vA 

public StereoVolume getVolume () { 
return this.volume; 


public void setVolume (StereoVolume volume) { 
this. volume=volume; 


public String toString () { 

StringBuffer buffer=new StringBuffer () ; 

buffer.append (getClass () .getName () ) .append ("@") .append 
(Integer. toHexString 

(hashCode () ) ) .append ("[") ; 

buffer.append ("title") .append ("='") .append (getTitle 
O ) .append ("'") ; 

buffer.append ("volume") .append ("='") .append (getVolume 
Q ) .append ("'") ; 

buffer.append ("sourceMedia") .append ("='") .append 
(getSourceMedia () ) .append ( 

TEKSI) ; 

buffer.append ("]") ; 

return buffer.toString () ; 


此 时 ， 可 以 执行 ant schema 命 令 来 重建 数据 库 表 ， 例 6-12 演 示 了 相 
天 的 结 


例 6-12: 根据 新 的 映射 而 创建 的 曲目 数据 库 模式 


[hibernatetool]create table TRACK (TRACK_ID integer generated by 
default as 
identity (start with 1) , TITLE varchar (255) not null, 
filePath varchar (255) not null, playTime time, added date, 
VOL_LEFT smallint, VOL_RIGHT smallint, sourceMedia varchar 
(255) , 
primary key (TRACK_ID) ) ; 


让 我 们 进一步 改进 数据 创建 的 测试 程序 ， 使 其 能 够 采用 新 的 Track 
结构 。 例 6-13 演 示 了 我 们 需要 做 出 的 修改 。 


例 6-13: 对 CreateTest,java 做 必要 的 修改 以 测试 立体 声音 量 


//Create some data and persist it 
tx=session.beginTransaction () ; 

StereoVolume fullVolume=new StereoVolume () ; 
Track track=new Track ("Russian Trance", 
"yvol2/album610/track02.mp3", 

Time.valueOf ("00: 03: 30") , 

new HashSet<Artist> () , 

new Date () , fullVolume, SourceMedia.CD, 

new HashSet<String> () ) ; 

addTrackArtist (track, getArtist ("PPK", true, session) ) ; 
session.save (track) ; 


track=new Track ("Test Tone 1", 

"vol2/singles/test01.mp3", 

Time.valueOf ("00: 00: 10") , new HashSet<Artist> () , 

new Date () , new StereoVolume ( (short) 50, (short) 75) , 

null, new HashSet<String> () ) ; 

track.getComments () .add ("Pink noise to test equalization") ; 
session.save (track) ; 


现在 ， 如 果 我 们 执行 ant ctest， 并 用 ant db 查看 结果 ， 就 会 看 到 如 图 
6-2 所 示 的 结 


eop -_ HSQL Database Manager 


B jdbc: hsgidb:data/music 
| -E ALBUM 
E ALBUM ARTISTS 
E ALBUM_CÖMMENTS 
E ALBUM TRACKS 


@ ARTIST | TRACK_ID|TITLE 
TRACK Russian Trance 


schema: PUBLIC 
E TRACKID video Killed the Radio Star 
E TITLE Gravity's Angel 


Ø FILEPATH Adagio for Strings (Ferry Corsten Remix) 100 

E PLAYTIME | Adagio for Strings (ATB Rermix] 

男 ADDED The Worid ‘9 

B YOL.LEFT Test Tone 1 
Typé SMALLINT 
Nullaibhe: true 

B YOL.RIGHT 
Type: SMALLINT 
Nullable: true 

国 SOURCEMEDIA 

E indices 

@ TRACK _ARTETS 


图 62 TRACK 表 中 的 立体 声音 量 信息 


为 了 让 AlbumTest 与 新 的 Track 格式 保持 兼容 ， 我 们 只 需要 对 
AlbumTest 做 一 处 修改 ， 如 例 6-14 所 示 。 


例 6-14: 对 AlbumTest.java 所 做 的 修改 ， 以 支持 立体 声 曲 目 首 量 


private static void addAlbumTrack (Album album, String title, 
String file, 

Time length, Artist artist, int disc, 

int positionOnDisc, Session session) { 

Track track=new Track (title, file, length, new HashSet<Artist> 


() 


new Date () , new StereoVolume () , SourceMedia.CD, 
new HashSet<String> () ) ; 


这 样 我 们 残 可 以 运行 ant atest 命 令 ， 查 看 新 版 的 Track 的 toString () 
方法 所 显示 的 音量 信息 ， 如 例 6-15 所 示 。 


例 6-15: 市 有 立体 声音 量 信息 的 专辑 


[java]com.oreilly.hh.data.Album@ccad9c[title='Counterfeit 
e.p.'tracks='[com.oreilly.hh.data.AlbumTrack@9c0287[track='com.oreil 
ly.hh.data.Track@6a21b2[title='Compulsion'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], c 
om.oreilly.hh.data.AlbumTrack@aa8eb7[track='com.oreilly.hh.data.Trac 
k@7fc8aO[t itle='In a Manner of Speaking 'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@4cadc4[track='com.oreilly.hh.data.Tra 
ck@243618[title='Smile in the Crowd'volume='Volume[left=100, 
right=100]'sourc eMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@5b644b[ track='com.oreilly.hh.d 
ata.Track@157e43[title='Gone'volume='Volume[left=100, 
right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@1483a0[track='com.oreilly.hh.data.Tra 
ck@cdae24[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@63dc28[track='com.oreilly.hh.data.Tra 
ck@ae511[title='Motherless Child'volume='Volume[left=100, 
right=100] 'sourceMedia='CD']']]'] 


WE, IX STAMIAA BERAT — A, Me RAT BEM 
型 所 需要 的 程度 。 但 是 ， 总 有 一 天 你 也 许 会 回 过 头 来 深入 研究 这 个 例 
子 ， 找 到 你 正在 寻找 的 主题 。 同 时 ， 接 下 来 让 我 们 换 档 去 看 一 看 完全 
不 同 、 全 新 而 且 人 简单 的 事物 。 第 7 章 将 介绍 一 种 完全 取代 XML 映 射 文档 


的 方法 。 第 8 章 将 介绍 条 件 查询 ， 这 是 Hibernate 独 特 的 功能 ， 对 于 程序 
员 来 说 这 个 功能 非常 友好 。 


其 他 


映射 自 定 义 类 型 还 有 哪些 奇特 的 诀 穿 ? 好 吧 ， 如 果 本 章 介绍 的 信 
息 还 不 够 用 ， 你 可 以 研究 一 下 org.hibernate.usertype 包 中 的 其 他 接口 ， 
包括 EnhancedUserType 〈 这 个 接口 将 目 定 义 类 型 作为 实体 的 id， 以 及 其 
他 有 趣 的 穿 门 ) 和 ParameterizedUserType (可 以 配置 它 支 持 多 种 不 同类 
型 的 映射 ) 等 。 在 Hibernate 维 基 的 Java5 EnumUserType (''!) 页 面 上 
也 讨论 了 针对 Java 5 enum 枚 举 类 型 的 可 重用 映射 ， 这 些 都 很 好 地 演示 
了 各 种 用 法 ， 只 是 对 它们 的 讨论 已 经 超出 了 本 书 的 范围 。 


[1] http:/www.hibernate.org/272.html. 


第 7 章 ”映射 标注 


到 目前 为 止 ， 我 们 一 直 在 用 XML 映射 文档 作为 我 们 示例 的 起 点 。 
在 这 种 情况 下 ， 以 一 个 概念 模型 作为 开始 ， 将 创建 数据 表 和 数据 对 象 
的 细 市 都 留 给 Hibernate， 同 时 也 保留 很 多 可 供 选 择 的 余地 。 然 而 ， 
Java 5 对 标注 (Annotation) 机 制 提 供 了 灵活 的 文 持 ， 这 一 技术 的 出 现 
为 Hibernate 映 射 提供 了 一 种 非常 有 趣 的 奉 代 方法 。 尤 其 是 当 你 已 经 拥 
有 了 一 些 现 有 的 对 象 ， 只 是 在 考虑 怎么 将 它们 保存 到 数据 库 时 ， 束 古 
这 种 新 的 蔡 代 方法 的 适用 场合 了 。 


Hibernate 标 注 


如 宁 你 以 前 从 没有 接触 过 标注 ， 本 章 的 代码 示例 将 看 起 来 有 点 奇 
怪 ， 所 以 ,现在 最 好 先 花 点 时 间 讨 论 一 下 Java 标 注 的 历史 和 目的 。 基 
本 上 ， 一 个 标注 就 是 为 一 段 代 码 添 加 一 些 信息 (在 Java 世 界 中 ， 通 常 
是 一 个 类 、 字 段 或 方法 ) ， 以 便 帮 助 其 他 工具 理解 如 何 使 用 这 段 代 
码 ， 或 是 进行 某 些 自动 化 处 理 以 节约 你 的 工作 量 。 与 持久 化 映射 不 同 
的 是 ， 为 了 与 源 代 码 保持 一 致 ， 不 用 将 标注 放 到 一 个 单独 的 文件 中 ， 
而 是 直接 将 标注 放 在 它 所 影响 的 源 代码 文件 中 。 采 用 这 种 方法 ， 你 就 
不 用 担心 与 源 代码 分 离 保 存 的 文件 是 否 会 变 得 与 源 代码 不 同步 了 。 早 


在 Java 5 为 这 种 编码 风格 提供 健壮 的 支持 以 前 ， 人 们 就 通过 利用 
JavaDoc 工 具 可 扩展 的 特性 ， 发 现 了 一 种 取得 这 种 支持 的 “后 门 ”。 


JavaDoc 也 是 一 种 形式 的 标注 ， 从 Java 开 始 就 一 直 存 在 ， 它 的 目的 
是 让 开发 人 员 为 他 们 的 类 和 API 生 成 高 质量 的 文档 ， 而 且 还 不 必 维 护 
除 源 代码 以 外 的 任何 文件 。JavaDoc 的 工作 效果 非常 好 ， 所 以 人 们 就 想 
用 它 来 做 些 其 他 事情 。XDoclet (1) 项 目 是 一 个 很 流行 ， 而 且 也 比 
较 复 杂 的 框架 ， 它 以 多 种 有 趣 的 方式 对 JavaDoc 进 行 了 扩展 。Hibernate 
也 开发 了 一 套 丰 富 的 Hibernate XDoclet 标 签 。 


也 正 因为 这 种 方法 的 功能 如 此 强大 ， 所 以 Sun 在 Java 5 中 内 建 了 完 
整 的 、 通 用 的 标注 支持 。 这 样 ， 束 不 再 需要 那些 借用 JavaDoc 注 释 的 复 
杂工 具 了 。 现 在 Java 编 译 器 本 身 就 可 以 处 理 标 注 (并 提供 了 它 自 己 的 
一 些 标注 来 控制 单独 的 类 、 方 法 甚至 字段 上 的 特定 警告 信息 ) 。 利 用 
反射 (reflection) 机 制 来 解析 标注 (如 果 将 它们 配置 为 要 保留 在 编译 
后 的 类 中 ) ， 也 能 够 非常 容易 地 定义 目 己 的 标注 类 。 所 以 ，Hibernate 
自然 采用 了 Java 5 的 原生 (native) 标注 。 


趋同 进化 (convergent evolution) 的 速度 如 此 之 快 ， 使 用 标注 为 类 
配置 映射 的 能 力 具 有 的 强大 吸引 力 ， 已 经 让 Hibernate 自 己 的 标签 深 深 
地 影响 了 EJB 3 规范 。 如 此 有 用 的 Hibernate 风 格 的 持久 化 要 是 能 够 在 成 
就 的 Java Enterprise Edition (EE) 环境 以 外 也 可 以 使 用 ， 这 给 人 们 留 
下 深刻 的 印象 ， 所 以 他 们 定义 了 Java Persistence API (经 常 称 为 


JPA) ， 作 为 一 种 可 以 在 普通 的 Java Standard Edition (SE) 环境 可 以 独 
立 使 用 的 持久 化 组 件 。 因 为 有 规范 作为 基础 ，Hibernate 上 自然 会 采用 直 
接 支 持 它们 ， 所 以 现在 通过 EJB 3 和 JPA 接 口 以 及 标注 ， 也 可 以 使 用 

Hibernate 能 够 提供 的 许多 功能 ， 而 应 用 程序 本 号 根本 不 必 依 赖 (或 知 


道 ) Hibernate ° 


我 们 不 打算 介绍 那么 多 功能 ， 因 为 我 们 在 Hibernate 中 使 用 的 一 些 
功能 需要 使 用 它 自己 的 标签 。 事 实 上 ， 在 你 习惯 使 用 Hibernate， 并 领 
会 到 它 是 一 种 非常 灵活 而 强大 的 体系 ， 可 以 “按照 你 需要 的 任何 方式 ， 
持久 化 任何 普通 Java 对 象 " 以 后 ， 你 会 发 现 按 照 JPA 规 范 的 要 求 来 封 凌 
你 的 代码 将 不 得 不 考虑 太 多 的 限制 ， 除 非 项 目 确实 强制 要 求 需要 屏蔽 
底层 的 持久 化 实现 〈 可 能 你 会 想 办 法 尽量 避免 这 样 的 项 目 ) 。 不 过 ， 
如 果 你 正在 使 用 Hibernate， 有 时 使 用 标注 而 不 是 XML 文件 来 配置 映 
射 ， 也 是 一 种 不 错 的 选择 。 


为 何在 意 


在 熟悉 了 标注 的 语法 以 后 〈 一 些 像 Eclipse 之 类 的 IDE 已 经 提供 了 
惊人 的 能 力 ， 文 持 标 注 的 理解 、 文 档 化 以 及 目 动 完成 ， 甚 至 目 定义 供 
你 目 己 使 用 的 标注 ， 第 14 章 将 介绍 这 种 技术 ) ， 编 写 映射 文档 束 只 需 
要 涉及 一 种 文件 格式 的 建立 和 读 取 了 。 


注意 : 什么 ! 为 什么 不 早点 介绍 这 么 酷 的 东西 ? 


如 前 所 述 ， 如 采 将 数据 对 象 和 映射 规定 都 放 在 同一 个 文件 中 ， 那 
么 它们 不 能 保持 同步 的 可 能 性 束 很 小 ， 阅 读 代 码 也 可 以 马上 理解 正在 
进行 的 处 理 。 添 加 标注 后 的 代码 将 是 一 种 自 文 档 化 的 (self- 
documenting) 代码 。 一 些 标注 提供 的 默认 设置 经 常 也 可 以 减少 你 需要 
进行 配置 的 工作 量 。 用 标注 指定 所 有 设置 ， 你 会 发 现 标注 语法 比 XML 
文件 更 精简 ， 而 且 需 要 输入 的 文字 量 比较 少 ， 或 者 让 IDE 帮 你 完成 输 
入 后 ， 只 要 读 一 下 就 可 以 了 。 


当 你 可 以 直接 控制 数据 库 时 ， 这 种 方法 可 能 会 很 有 成 效 ， 只 是 这 
种 方法 会 将 映 映 和 数据 对 象 紧 密 地 耦合 在 一 起 〈 或 者 ， 如 果 你 正在 设 
计数 据 对 象 以 处 理 特定 的 、 固 定格 式 的 数据 库 结 构 ， 这 样 也 同样 会 产 
EZERA) 。 这 意味 着 ， 如 果 你 想 用 一 个 对 象 模型 来 文 持 多 个 数据 
库 ， 使 用 标注 束 不 是 一 种 好 的 选择 了 ; 在 这 种 情况 下 ， 外 部 映射 文件 
的 独立 性 其 实 是 它 的 优势 ， 因 为 不 需要 修改 Java 源 代码 ， 只 要 为 不 同 
的 数据 库 提 供 单 独 的 映射 文件 束 可 以 了 。 


许多 其 他 Java 工 具 也 采用 标注 作为 配置 和 集成 的 手段 ， 第 13 草 将 
介绍 相关 内 容 。 在 使 用 这 些 工 具 时 ， 同 时 也 使 用 Hibernate 的 标注 也 是 
非 党 方便 的 。 其 实 ， 其 他 工具 可 能 也 要 依赖 Hibernate 标 注 。 束 算 我 们 
不 计划 在 本 书 的 新 版 中 介绍 标注 的 使 用 ， 介 绍 Spring 的 那 一 章 也 会 强 
制 我 们 面 对 这 一 问题 。 


对 于 标注 的 批评 之 一 就 是 它 让 数据 库 细 市 分 散 到 Java 源 代码 的 各 
个 角落 。 所 幸 ， 一 些 有 用 的 Hibernate 工 具 可 以 根据 Hibernate XML 映射 
文件 和 Hibernate 标 注 生成 Hibernate 映 射 文档 。 有 关 hbm2doc 的 更 多 信 
息 ， 请 参阅 第 12 章 的 12.8.2 节 © 
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Hibernate 标 注 库 。 编 辑 build.xml 文 件 中 的 依赖 设置 ， 如 例 7-1 所 示 〈 增 
加 的 部 分 用 粗 体 显 示 ) 。 


例 7-1: 获得 Hibernate 标 注 


<artifact: dependencies pathId="dependency.class.path"> 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency > 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 

version="3.2.0.beta9a"/> 

<dependency groupId="org.hibernate"artifactId="hibernate- 
annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.hibernate" 

artifactId="hibernate-commons-annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.apache.geronimo.specs" 

artifactId="geronimo-jta_1.1_spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 

</artifact: dependencies > 


AT AG, OA 。 因为 我 们 
要 使 用 标注 ， 所 以 就 不 用 生成 Java 代 码 了 。 男 一 方面 ， 我 们 将 从 Java 
代码 文件 入 手 ， 用 它 来 定义 Hibernate 映 射 ( 以 及 数据 库 模 式 ) ， 所 以 
在 本 章 中 应 该 废弃 这 两 个 构建 目标 《它们 甚至 是 危险 的 ) 


可 以 想到 ， 为 了 适应 这 种 新 方法 ， 还 需要 对 schema 构 建 日 标 稍微 
调整 一 下 ， 如 例 7-2 中 突出 显示 部 分 所 示 。 


例 7-2: 使 用 标注 生成 数据 库 模 式 


<! --Generate the schemas for annotated classes-->@ 

<target name="schema"depends="compile" 

description="Generate DB schema from the annotated model 
classes"> 

<hibernatetool destdir="${source.root}"> 

<classpath refid="project.class.path"/>@® 

<annotationconfiguration 

configurationfile="${source.root}/hibernate.cfg.xml"/>® 

<hbm2dd1 drop="yes"/> 

</hibernatetool> 

</target> 


@ 需 要 更 新 注释 和 构建 目标 描述 ， 以 反映 新 的 工作 方式 。 


@ 我 们 需要 引用 编译 好 的 类 ， 以 便 模 式 生 成 工具 可 以 找到 其 中 的 
标注 。 注 意 ， 这 意味 着 在 生成 模式 之 前 ， 需 要 先 把 类 编译 好 ， 这 样 的 
处 理 顺 序 与 该 构建 目标 前 面 的 大 多 数 版 本 都 不 相同 ， 但 是 在 第 6 章 中 增 
加 了 这 个 依赖 ， 所 以 我 们 的 schema 构 建 目标 已 经 依赖 编译 目标 了 。 


日 最 后 ， 让 工具 使 用 标注 来 配置 它 目 己 。 我 们 仍旧 提供 一 个 全 局 
的 Hibernate 配 置 文件 ， 以 便 工 具 可 以 知道 我 们 正在 使 用 什么 数据 库 等 
言 轧 。 这 个 文件 也 必须 列 出 我 们 想 使 用 的 所 有 标注 类 ， 在 调整 完 所 有 
构建 文件 后 ， 我 们 再 处 理 它 。 


我 们 的 compile 构 建 目标 需要 依赖 刚才 删除 挥 的 代码 生成 构建 目 
标 ， 所 以 在 删除 这 一 依赖 以 前 ， 这 个 构建 目标 不 能 运行 。 在 我 们 的 新 
方法 中 ， 为 了 文 持 编译 而 所 有 需要 做 的 束 是 让 基本 的 prepare 构 建 目 标 
可 以 运行 。 编辑 compile 构 建 目 标 ， 以 反映 例 7-3 中 突出 显示 部 分 的 变 
化 。 


例 7-3: 更 简单 的 编译 依赖 


<! --Compile the java source of the project--> 
<target name="compile"depends="prepare" 
description="Compiles all Java classes"> 
<javac srcdir="${source.root}" 
destdir="${class.root}" 
debug="on"optimize="o0ff"deprecation="on" > 
<classpath refid="project.class.path"/> 
</javac> 

</target> 


如 前 面 所 述 ， 我 们 需要 更 新 Hibernate 配 置 ， 将 原来 使 用 的 映射 文 
档 列表 替换 为 相应 标注 过 的 类 (annotated classes) 的 列表 。 删 除 那些 
映射 文档 ， 修 改 src 目 录 下 hibernate.cfg.xml 文 件 的 末尾 部 分 ， 如 例 7-4 
Pras (同样 ， 和 需要 修改 的 部 分 以 粗 体 字 显 示 ) 。 


例 7-4: 配置 Hibernate 使 用 标注 


<! --Don't echo all executed SQL to stdout--> 

<property name="show_sql">false</property > 

<! --disable batching so HSQLDB will propagate errors 
correctly.--> 

<property name="jdbc.batch_size" >0</property> 

<! --List all the annotated classes we're using--> 

<mapping class="com.oreilly.hh.data.Album"/ > 

<mapping class="com.oreilly.hh.data.AlbumTrack"/ > 

<mapping class="com.oreilly.hh.data.Artist"/> 

<mapping class="com.oreilly.hh.data.Track"/> 

</session-factory> 

</hibernate-configuration> 


为 什么 必须 这 么 做 


你 可 能 会 问 ， 为 什么 需要 在 配置 文件 中 列 出 标注 过 的 类 ? 
Hibernate 不 能 通过 类 的 标注 而 自己 找到 它们 ? 嗯 ， 可 以 找到 它们 ， 如 
果 你 修改 编码 风格 ， 完 全 依靠 JPA 接 口 〈 使 用 JPA EntityManager 的 
Hibernate 实 现 ， 而 不 是 使 用 Hibernate Session) ， 不 用 告诉 Hibernate 到 
哪 找 标注 过 的 类 ，Hibernate 目 己 就 可 以 找到 它们 ， 真 令 人 高 兴 。 但 
是 ， 如 前 面 所 述 ， 本 书 不 打算 在 标注 上 做 过 多 介绍 。 如 果 坚 持 使 用 
Hibernate 的 原生 接口 ， 就 应 该 显 式 声明 用 于 执行 持久 化 的 类 ， 即 使 是 
在 使 用 标注 来 控制 持久 化 时 ， 也 应 该 这 么 做 。 


我 们 差不多 已 经 做 好 准备 工作 了 ， 束 靶 用 标注 过 的 类 来 组 成 这 种 
方法 的 核心 ! 接 下 来 束 介 绍 本 章 真 正 有 趣 的 部 分 ， 看 看 数据 对 象 的 


Java 源 代码 标注 长 得 什么 样 儿 ， 它 是 怎么 控制 Hibernate 映 射 的 。 


[1] http://xdoclet.sourceforge.net/xdoclet/index.html. 


为 模型 对 象 涩 加 标注 


可 以 在 许多 Java 元 素 上 应 用 标注 。 在 使 用 Hibernate 时 ， 通 汕头 注 
的 是 对 类 和 它 的 字段 进行 标注 ， 以 指定 如 何 将 模型 对 象 映 映 到 数据 库 
模式 。 这 类 似 于 XML 映射 文档 是 被 映射 的 类 和 属性 的 结构 化 描述 方 
式 。 已 经 进行 了 足够 的 背景 介绍 和 解释 ， 接 下 来 束 深 入 主题 ， 以 具体 
的 实例 (在 第 6 章 中 开发 的 完整 例子 ， 来 看 看 如 何 使 用 标注 对 类 进行 映 
HT e 


DAE A ti 


例 7-5 演 示 了 一 种 对 Artist 类 进行 标注 的 方法 。 本 章 只 是 介绍 
Hibernate Annotations 的 基础 ， 如 果 你 想 更 加 彻底 地 了 解 这 些 标注 ， 请 
参考 Hibernate Annotations 项 目 网 站 ， 它 的 网 址 是 
http://annotations.hibernate.org (1!) 。 为 了 节省 篇 幅 ， 对 下 载 的 完整 
源 代码 中 的 标注 类 进行 了 一 定 的 压缩 ， 压 缩 了 空白 字符 ， 省 略 了 
JavaDoc 注 释 。 由 于 这 些 源 代码 是 手工 编写 的 类 ， 而 不 是 像 前 儿 章 中 用 
代码 生成 工具 生成 的 类 ， 所 以 就 有 空间 为 这 些 代码 加 入 更 多 、 更 详细 
的 JavaDoc 注 释 。 建 议 你 也 看 看 下 载 到 的 源 代码 ， 很 有 价值 。 


例 7-5: 标注 Artist 类 


package com.oreilly.hh.data; 

import java.util.*; 

import javax.persistence.*; @ 

import org.hibernate.annotations. Index; 

@Entity® 

@Table (name="ARTIST") 

@NamedQueries ({ 

@NamedQuery (name="com.oreilly.hh.artistByName", 

query="from Artist as artist where upper (artist.name) =upper (: 
name) ") 

}) 

public class Artist{ 

@Id® 

@Column (name="ARTIST_ID") 

@GeneratedValue (strategy=GenerationType.AUTO) 

private Integer id; 

@Column (name="NAME", nullable=false, unique=true) @ 

@Index (name="ARTIST_NAME", columnNames={"NAME"}) © 

private String name; 

@ManyToMany® 

@JoinTable (name="TRACK_ARTISTS", 

joinColumns={@JoinColumn (name="TRACK_ID") }, 

inverseJoinColumns={@JoinColumn (name="ARTIST_ID") }) 

private Set<Track> tracks; 

@ManyToOne®@ 

@JoinColumn (name="actualArtist") 

private Artist actualArtist; 

public Artist () {} 

public Artist (String name, Set<Track>tracks, Artist 
actualArtist) { 

this .name=name; 

this.tracks=tracks; 

this.actualArtist=actualArtist; 

} 

public Integer getId () {return id; } 

public void setId (Integer id) { 

this.id=id; 


public String getName () {return name; } 

public void setName (String name) { 

this .name=name; 

} 

public Artist getActualArtist () {return actualArtist; } 
public void setActualArtist (Artist actualArtist) { 
this.actualArtist=actualArtist; 

} 

public Set<Track>getTracks () {return tracks; } 

public void setTracks (Set<Track>tracks) { 


this.tracks=tracks; 


} 

JAZ 

*Produce a human-readable representation of the artist. 
* 


*@return a textual description of the artist. 
*/ 
public String toString () { 
StringBuilder builder=new StringBuilder () ; 
builder.append (getClass () .getName () ) .append ("@") ; 
builder.append (Integer.toHexString (hashCode () ) ) .append (" 
[") ; 
builder .append ("name") .append ("='") .append (getName 
Q ) .append ("'") ; 
builder .append ("actualArtist") .append ("='") .append 
(getActualArtist () ) ; 
builder.append ("'") .append ("]") ; 
return builder.toString () ; 
} 
} 


@ 为 了 使 用 非 核 心 Java 语 言 目 身 的 标注 ， 例 如 我 们 在 这 里 讨论 的 
与 持久 化 相关 的 标注 ， 得 先导 入 它们 。 标 注 其 实 也 只 是 Java 类 (RE 
这 些 类 会 实现 一 个 特殊 的 接口 ， 但 它们 的 声明 方法 有 些 意思 ， 相 关 介 
绍 已 经 超出 本 章 讨论 的 范围 ， 有 兴趣 的 话 可 以 阅读 第 14 章 ) ， 所 以 使 
用 普通 的 import 语 句 像 这 样 导入 它们 就 可 以 了 。 


如 前 所 述 ， 我 们 在 这 里 需要 使 用 的 大 多 数 标注 都 是 由 标准 的 EJB 3 
标注 (在 javax.persistence 包 中 定义 ) 演化 而 来 的 。 我 们 之 所 以 需要 一 
个 Hibernate 特 定 的 标注 ， 是 为 了 能 够 获得 一 个 特定 的 索引 Maven 会 目 
动 下 载 并 让 我 们 能 够 使 用 Java Persistence API， 因 为 我 们 在 更 新 过 的 
build.xml 中 要 求 它 是 Hibernate Annotations 的 一 个 依赖 。 我 们 可 以 像 这 
样 单独 地 使 用 Java Persistence API， 因 为 JDK 中 专门 设计 让 它 在 Java SE 


环境 中 可 以 单独 使 用 ， 在 Java EE 中 也 内 建 了 一 部 分 对 EJB 的 文 持 。 如 
果 你 想 了 解 更 多 内 容 ， 它 的 主页 (7!) 就 是 一 个 好 的 起 点 。 


@ 应 用 到 Artist 类 上 的 这 组 标注 是 一 个 整体 。Entity 标 注 将 这 个 类 
标记 为 可 持久 化 的 。Table 标 注 是 可 选 的 ， 标 注 处 理 右 将 为 标注 提供 非 
常 合理 的 默认 假设 ,但 是 我 们 在 这 里 想 演 示 如 何 明确 地 指定 表 名 ， 以 
防止 把 错误 的 名 称 连接 到 现 有 的 数据 库 。 


注意 : 这 种 查询 语言 关系 表明 在 很 大 程度 上 Hibernate 确 实 影响 了 
EJB 3 的 发 展 方向 。 


那么 我 们 的 查询 在 Java 源 代码 中 到 底 做 了 什么 ? 唉 ， 这 是 在 使 用 
标注 时 ，Hibernate 原 生 接 口 表现 出 来 的 另 一 个 缺点 : 没有 放置 命名 查 
询 的 地 方 。 如 果 我 们 使 用 JPA EntityManager， 就 可 以 将 命名 查询 放 在 
一 个 persistence.xml 文 件 中 ， 这 样 承 保留 了 将 SQL 语句 和 Java 源 代码 互 
相 分 离 的 优点 。 由 于 在 本 书 中 我 们 坚持 使 用 会 话 接 口 ， 这 样 当 我 们 使 
用 标注 而 不 是 XML 映射 文件 时 ， 束 丧失 了 使 用 命名 查询 的 优点 。 但 是 
我 们 仍然 可 以 用 HQL 编 写 查 询 ， 使 用 它 的 所 有 功能 。 如 采 换 用 JPA 搂 
口 ， 就 得 使 用 JPAQL ( 它 是 HQL 的 一 个 子 集 ) 。 


四 这 里 演示 了 如 何 标 注 映 射 属性 。 这 是 一 个 特殊 的 例子 ， 因 为 要 
标注 的 属性 也 是 对 象 的 惟一 标识 符 ， 如 @Id 标 注 所 示 。 可 以 用 标注 指 
定 不 同 的 ID 生成 策略 ， 就 像 用 Hibernate 的 XML 映射 文档 一 样 (标注 则 


在 完全 取代 现 有 OAR 层 的 功能 ， 标 准 的 JPA 选 择 以 及 Hibernate 目 己 的 标 
注 ， 实 际 上 你 差不多 可 以 做 想 要 的 任何 事情 了 ) 。 为 生成 风格 选择 
AUTO， 相 当 于 在 XML 中 指定 < generator class="native"/ > 的 基于 标注 
的 等 价 物 。 它 告诉 Hibernate 使 用 对 于 数据 库 来 说 最 自然 的 任何 处 理 方 
Ae 


与 实体 级 的 标注 一 样 ， 你 可 以 省 略 一 些 选 择 (例如 列 名 ) ， 默 认 
的 选项 就 相当 合理 ， 但 我 们 在 这 里 想 演 示 当 你 有 特殊 需要 时 如 何 进行 
配置 。 事 实 上 ， 根 本 不 需要 为 属性 添加 标注 一 JPA 将 假设 实体 的 所 有 
属性 都 要 上 映射， 除非 特别 指定 (要 是 通过 标注 的 话 ， 自 然 是 : 
@Transient 用 于 这 一 目的 ) 。 


也 要 注意 ， 我 们 是 将 标注 加 到 了 实际 的 字段 ， 而 不 是 访问 吉方 法 
上 。 这 有 是 告诉 Hibernate 直 接 访 问 字 段 ， 而 访问 磊 在 一 个 类 中 适合 在 运 
行 时 为 其 他 类 提供 抽象 ， 但 这 样 与 持久 化 又 不 能 保持 兼容 。 在 许多 情 
况 下 ， 你 可 能 想 让 Hibernate 使 用 访问 器 方法 ， 只 要 将 标注 放 到 相应 的 
getter 或 setter 方 法 上 整 可 以 了 。 你 需要 挑 出 一 个 方法 或 其 他 方法 ， 但 属 
性 之 间 的 混合 和 匹配 还 不 支持 〈 通 过 JPA， 再 加 上 Hibernate 的 一 些 扩 
展 .……… 即 便 你 能 够 这 样 做 ， 也 可 能 引起 其 他 的 混乱 ) 。 


@ 当 对 列 进行 映射 时 ， 可 以 用 许多 可 选 的 属性 来 控制 映射 结 采 ， 
例如 是 否 为 null、 人 惟一 约束 等 等 ， 就 像 在 XML 了 映射 文件 中 的 配置 一 
样 。 


@ 为 了 能 够 指定 一 个 列 应 该 有 一 个 索引 (以 及 如 何 建立 索引 ) ， 
是 我 们 在 这 个 例子 中 增加 Hibernate 标 注 的 一 个 原因 。@Index 标 签 不 是 
标准 JPA 标 注 的 一 部 分 ， 它 是 一 个 有 用 的 Hibernate 扩 展 。 使 用 这 个 标注 
就 让 我 们 的 代码 需要 依靠 Hibernate， 但 除了 这 是 一 本 有 关 Hibernate 的 
书 这 一 事实 以 外 ， 如 前 所 述 (后 面 也 会 介绍 ) ， 还 有 许多 原因 可 以 解 
释 为 什么 你 将 经 常 要 做 出 同样 的 选择 。 


@ 和 了 映 册 文档 一 样 ， 在 关联 配置 上 也 有 更 多 的 选项 。 在 这 个 例子 
中 ， 我 们 描述 了 一 个 Track 之 间 的 多 对 多 关系 ， 显 式 地 描述 出 在 数据 库 
中 如 何 表达 这 一 关系 。 


@ 有 时 你 不 需要 在 标注 中 配置 很 多 东西 ， 即 使 你 很 清楚 这 些 配 
置 。 这 个 例子 是 为 了 演示 标注 为 何 要 比 XML 了 映射 文件 更 加 简洁 。 我 们 
使 用 @JoinColumn 标 注 来 设置 列 名 (与 基于 XML 的 配置 方法 一 样 ) 。 
如 果 没 有 这 个 标注 ， 也 能 正常 运行 ， 但 是 默认 的 列 名 稍微 有 点 见长 : 
ACTUALARTIST_ARTIST_ID 。 


除了 以 上 这 段 代 码 ， 这 个 类 没什么 可 介绍 的 了 ， 它 是 一 个 简单 的 
数据 pean， 与 前 儿 章 中 根据 映射 文档 生成 的 数据 类 非常 相似 。 下 载 到 
的 代码 中 的 JavaDoc 广 释 ， 详 细 的 解释 了 字段 和 方法 的 作用 ， 比 前 面 用 
工具 生成 的 代码 中 的 注释 详细 多 了 。 


这 个 标注 过 的 类 生成 的 ARTIST 数 据 表 ， 与 前 面 儿 章 中 根据 
Artisthbm.xml 有 映射 文 档 而 得 到 的 ARTIST 表 完全 相同 。 


标注 Track 类 


标注 过 的 Artist 类 需要 引用 Track 类 。 例 7-6 演 示 了 Track 类 中 的 标 
注 ， 其 中 也 引入 了 一 些 新 的 问题 。 


例 7-6: 标注 Track 类 


package com.oreilly.hh.data; 

import java.sql.Time; 

import java.util.*; 

import javax.persistence.”*; 

import org.hibernate.annotations.CollectionOfElements; 
import org.hibernate.annotations. Index; 

@Entity 

@Table (name="TRACK") 

@NamedQueries ({ 

@NamedQuery (name="com.oreilly.hh.tracksNoLongerThan", 
query="from Track as track where track.playTime<=: length") 
P 

public class Track{ 

@Id 

@Column (name="TRACK_ID") 

@GeneratedValue (strategy=GenerationType.AUTO) 

private Integer id; 

@Column (name="TITLE", nullable=false) 

@Index (name="TRACK_TITLE", columnNames={"TITLE"}) 
private String title; 

@Column (nullable=false) 

private String filePath; 

@Temporal (TemporalType.TIME) @ 

private Date playTime; 

@ManyToMany 

@JoinTable (name="TRACK_ARTISTS", 
joinColumns={@JoinColumn (name="ARTIST_ID") }, 
inverseJoinColumns={@JoinColumn (name="TRACK_ID") }) 


private Set<Artist>artists; 

@Temporal (TemporalType.DATE) @ 

private Date added; 

@CollectionoOfElements® 

@JoinTable (name="TRACK_COMMENTS", 

joinColumns=@JoinColumn (name="TRACK_ID") ) 

@Column (name=" COMMENT") 

private Set<String> comments; 

@Enumerated (EnumType.STRING) @ 

private SourceMedia sourceMedia; 

@Embedded® 

@AttributeOverrides ({@ 

@AttributeOverride (name="left", column=@Column 
(name="VOL_LEFT") ) , 

@AttributeOverride (name="right", column=@Column 
(name="VOL_RIGHT") ) 

}) 

StereoVolume volume; 

public Track () {} 

public Track (String title, String filePath) { 

this.title=title; 

this.filePath=filePath; 

} 

public Track (String title, String filePath, Time playTime, 

Set<Artist>artists, Date added, StereoVolume volume, 

SourceMedia sourceMedia, Set<String>comments) { 

this.title=title; 

this.filePath=filePath; 

this.playTime=playTime; 

this.artists=artists; 

this .added=added; 

this .volume=volume; 

this .sourceMedia=sourceMedia; 

this.comments=comments; 

} 

public Date getAdded () {return added; } 

public void setAdded (Date added) { 

this .added=added; 

} 

public String getFilePath () {return filePath; } 

public void setFilePath (String filePath) { 

this.filePath=filePath; 

} 

public Integer getId () {return id; } 

public void setId (Integer id) { 

this.id=id; 

} 

public Date getPlayTime () {return playTime; } 


public void setPlayTime (Date playTime) { 

this .playTime=playTime; 

} 

public String getTitle () {return title; } 

public void setTitle (String title) { 

this.title=title; 

} 

public Set<Artist>getArtists () {return artists; } 

public void setArtists (Set<Artist>artists) { 

this.artists=artists; 

} 

public Set<String>getComments () {return comments; } 

public void setComments (Set<String>comments) { 

this .comments=comments; 

} 

public SourceMedia getSourceMedia () {return sourceMedia; } 

public void setSourceMedia (SourceMedia sourceMedia) { 

this .sourceMedia=sourceMedia; 

} 

public StereoVolume getVolume () {return volume; } 

public void setVolume (StereoVolume volume) { 

this .volume=volume; 

} 

public String toString () {0 

StringBuilder builder=new StringBuilder () ; 

builder.append (getClass () .getName () ) .append ("@") ; 

builder.append (Integer.toHexString (hashCode () ) ) .append (" 
[") ; 

builder.append ("title") .append ("='") .append (getTitle 
Q ) .append ("'") ; 

builder.append ("volume") .append ("='") .append (getVolume 
O ) .append ("'") ; 

builder.append ("sourceMedia") .append ("='") .append 
(getSourceMedia () ) ; 

builder.append ("'") .append ("]") ; 

return builder.toString () ; 

} 

} 


@ 与 日 期 类 型 Date 〈 或 者 是 时 间 戳 timestamp， 包 括 时 间 和 日 期 ) 
相 比 ， 由 于 Java 缺 少 明 确 的 类 来 表示 一 天 中 的 时 间 ， 我 们 束 需 要 一 种 
方法 来 声明 如 何 使 用 Date 类 。@Temporal 标 注 提供 了 这 样 的 功能 。 在 


这 个 例子 中 我 们 标注 playTime 对 应 于 SQL 中 的 TIME 列 。 如 果 名 略 这 个 
标注 ， 默 认 的 列 类 型 将 是 TIMESTAMP ° 


@added 属 性， 虽然 它 与 playTime 具 有 同样 的 Date 类 型 ， 但 对 应 于 
一 个 DATE 列 。 


B@@CollectionOfElements 标 注 也 是 一 个 Hibernate 扩 F, XIT EN 
单 值 类 型 集合 的 关联 ， 它 为 我 们 控制 这 些 类 型 映射 到 的 表 和 列 提供 了 
一 种 更 简单 的 方法 。 这 是 我 们 之 所 以 要 使 用 非 标准 标注 的 主要 原因 之 
一 。 使 用 纯 JPA， 就 根本 不 能 直接 映射 简单 值 类 型 (例如 String 或 
Iteger) 的 集合 。 这 需要 声明 一 个 完整 的 实体 类 来 持 有 这 样 的 值 ， 接 
着 再 映射 这 个 类 。 对 于 那些 习惯 用 Hibernate 映 射 POJO (Plain Old Java 
Object) 的 灵活 性 的 人 ， 这 可 能 是 一 大 退步 。 


@ 必 一 方面 ， 对 于 内 建 枚 举 类 型 的 映射 ，JPA 提 供 了 强大 的 文 持 ， 
这 是 Java 5 enum 问 世 以 来 给 我 们 带 来 的 一 个 好 处 (类 型 安全 的 枚 举 类 
型 模式 的 广泛 采纳 成 就 了 这 一 语言 功能 ) 。 这 个 标注 比 我 们 在 第 6 章 中 
用 过 的 要 更 加 人 简单 ! 


日 这 是 用 JPA 标 注 来 映射 复合 目 定 义 类 型 的 标准 用 法 ， 相 当 于 例 6- 
10。JPA 规 范 要 求 当 我 们 进行 这 样 的 映射 时 ， 同 时 要 将 StereoVolume 类 
标记 为 可 租 入 的 : 


package com.oreilly.hh.data; 


import java.io.Serializable; 
import javax.persistence.Embeddable; 
* k 


*A simple structure encapsulating a stereo volume level. 
* 


@Embeddable 
public class Stereovolume implements Serializable{ 


(ŒE, Hibernate Fl LYRA HRA RE, NEC ik 
ERINLE ° ANE DUA AC AT HAR A] BES EI es 
范 ， 所 以 按 规 矩 办 事 并 无 大 碍 。) 


@ 再 一 次 ， 我 们 添加 了 超过 实际 需要 的 标注 ， 为 的 是 生成 与 基于 
XML 的 映射 版 本 的 例子 中 完全 一 样 的 数据 库 模 式 。 如 果 不 用 
@AttributeOverrides 标 注 ， 用 于 保存 两 个 音量 的 列 将 是 LEFT 和 RIGHT 

(StereoVolume 类 中 的 属性 名 称 ) ， 而 不 是 VOL_LEFT 和 
VOL _ RIGHT。 


@ 为 了 让 我 们 的 测试 程序 可 以 打印 输出 与 原来 的 旧 方 法 一 样 的 信 
息 ， 我 们 复制 了 Hibermate 代 码 生 成 器 为 我 们 创建 的 toString () 实现 。 
注意 ， 我 们 可 以 借 这 个 机 会 来 更 新 它们 ， 使 用 StringBuilder， 而 没有 必 
要 非得 使 用 线程 安全 (BI) (但 速度 更 慢 ) 的 StringBuffer 。 


这 套 标 注 可 以 创建 TRACK、TRACK_ARTISTS 以 及 
TRACK_COMMENTS 数 据 表 ， 与 例 2-1 到 例 6-10 中 使 用 Track.hbm.xml 
生成 的 数据 库 模 式 一 样 。 


标注 Album 类 


Album 类 是 目前 我 们 构建 的 其 他 示例 的 核心 模型 类 。 例 7-7 演 示 了 
如 何 对 它 进行 标注 ， 以 重 狐 创建 我 们 正在 处 理 的 数据 库 模 式 和 映射 ， 
同时 也 引入 几 个 不 用 再 多 介绍 的 概念 。 


例 7-7: 标注 Album 类 


package com.oreilly.hh.data; 

import java.util.*; 

import javax.persistence.’*; 

import org.hibernate.annotations.CollectionOfElements; @ 
import org.hibernate.annotations. Index; 

import org.hibernate.annotations.IndexColumn; 
@Entity 

@Table (name="ALBUM") 

public class Album{ 

@Id 

@Column (name="ALBUM_ID") 

@GeneratedValue (strategy=GenerationType.AUTO) 
private Integer id; 

@Column (name="TITLE", nullable=false) 

@Index (name="ALBUM_TITLE", columnNames={"TITLE"}) 
private String title; 

@Column (nullable=false) 

private Integer numDiscs; 

@ManyToMany (cascade=CascadeType.ALL) 
@JoinTable (name="ALBUM_ARTISTS", 
joinColumns=@JoinColumn (name="ARTIST_ID") , 
inverseJoinColumns=@JoinColumn (name="ALBUM_ID") ) 
private Set<Artist>artists; 
@CollectionOfElements 

@JoinTable (name="ALBUM_COMMENTS", 
joinColumns=@JoinColumn (name="ALBUM_ID") ) 
@Column (name=" COMMENT") 

private Set<String> comments; 

@Temporal (TemporalType .DATE) 

private Date added; 

@CollectionOfElements® 


@IndexColumn (name="LIST_POS") © 

@JoinTable (name="ALBUM_TRACKS", 
joinColumns=@JoinColumn (name="ALBUM_ID") ) 
private List <AlbumTrack> tracks; 

public Album () {} 

public Album (String title, int numDiscs, Set<Artist>artists, 
Set<String>comments, List<AlbumTrack>tracks, 
Date added) { 

this.title=title; 

this .numDiscs=numDiscs; 

this.artists=artists; 

this .comments=comments; 

this. tracks=tracks; 

this .added=added; 

} 

public Date getAdded () {return added; } 

public void setAdded (Date added) { 

this .added=added; 


public Integer getId () {return id; } 

public void setId (Integer id) { 

this .id=id; 

} 

public Integer getNumDiscs () {return numDiscs; } 
public void setNumDiscs (Integer numDiscs) { 

this .numDiscs=numDiscs; 

} 

public String getTitle () {return title; } 

public void setTitle (String title) { 
this.title=title; 

} 

public List<AlbumTrack>getTracks () {return tracks; } 
public void setTracks (List<AlbumTrack>tracks) { 
this.tracks=tracks; 


public Set<Artist>getArtists () {return artists; } 

public void setArtists (Set<Artist>artists) { 

this.artists=artists; 

} 

public Set<String>getComments () {return comments; } 

public void setComments (Set<String>comments) { 

this .comments=comments; 

$ 

public String toString () { 

StringBuilder builder=new StringBuilder () ; 

builder.append (getClass () .getName () ) .append ("@") ; 

builder.append (Integer.toHexString (hashCode () ) ) .append (" 
[") ; 


builder.append ("title") .append ("='") .append (getTitle 
O ) .append ("'") ; 

builder.append ("tracks") .append ("='") .append (getTracks 
O ) append ("'") ; 

builder.append ("]") ; 

return builder.toString () ; 


} 


@ 是 的 ， 没 有 Hibernate 特 定 的 扩展 ， 还 是 不 行 。 在 这 个 类 中 至 少 
需要 3 个 引用 的 类 。 


@AlbumTrack 不 是 一 个 实体 〈 它 没有 ID 属性 ， 脱 离 了 Album 记 
录 ， 就 不 能 独立 地 查询 它们 的 实例 ) 。 所 以 我 们 使 用 
@CollectionOfElements 标 注 (就 像 我 们 前 面 映射 基本 类 型 一 样 ) ， 而 
不 是 @OneToMany (用 于 映射 实体 ) 


日 对 于 集合 映 映 ，JPA 和 EJB 只 文 持 set 之 类 的 语义 。 如 第 5 章 所 
述 ， 能 够 以 特定 的 顺序 来 保存 记录 也 很 重要 ， 这 就 是 为 什么 我 们 要 使 
用 像 List 和 array (数组 ， 之 类 的 数据 结构 ，Hibernate 可 以 容易 地 映射 
这 种 有 序 集合 。 不 过 ， 如 果 只 用 JPA， 就 无 法 映射 这 样 的 集合 了 |! 
Hibernate 的 @IndexColumn 扩 展 提供 了 一 种 权宜 之 计 。 


把 这 个 标注 和 @JoinColumn 信 息 组 合 在 一 起 ， 就 可 以 让 Hibernate 
生成 与 基于 例 5-4 中 的 Album.hbm.xml 而 得 到 数据 库 模 式 完全 一 样 的 结 
果 ， 其 中 ALBUM_TRACKS 表 具有 一 个 复合 主键 (由 ALBUM_ID 和 


LIST POS 组 成 ) 


Album 类 与 AlbumTrack 类 密切 相关 ，AlbumTrack 的 标注 过 程 如 例 
7-8 所 示 ， 同 样 也 会 重新 创建 我 们 的 示例 数据 库 模 式 。 


例 7-8: 标注 AlbumTrack 类 


package com.oreilly.hh.data; 

import java.io.Serializable; 

import javax.persistence.’*; 

@Embeddable® 

public class AlbumTrack{ 

@ManyToOne (cascade=CascadeType.ALL) @ 

@JoinColumn (name="TRACK_ID", nullable=false) 

private Track track; 

private Integer disc; © 

private Integer positionOnDisc; 

public AlbumTrack () {} 

public AlbumTrack (Track track, Integer disc, Integer 
positionOnDisc) { 

this.track=track; 

this .disc=disc; 

this .positionOnDisc=positionOnDisc; 

} 

public Track getTrack () {return track; } 

public void setTrack (Track track) { 

this.track=track; 


public Integer getDisc () {return disc; } 
public void setDisc (Integer disc) { 
this .disc=disc; 
} 
public Integer getPositionOnDisc () {return positionOnDisc; } 
public void setPositionOnDisc (Integer positionOnDisc) { 
this .positionOnDisc=positionOnDisc; 
} 
public String toString () { 
StringBuilder builder=new StringBuilder () ; 
builder.append (getClass () .getName () ) .append ("@") ; 
builder.append (Integer.toHexString (hashCode () ) ) .append (" 
EY ; 
builder.append ("track") .append ("='") .append (getTrack 
() ) .append ("'") ; 
builder.append ("]") ; 
return builder.toString () ; 


Www 


@ 正 如 前 面 对 Album 类 映射 的 讨论 ， 这 个 类 是 一 个 不 可 以 独立 存 
在 的 实体 ， 所 以 我 们 用 @Embeddable 进 行 标 注 ， 和 StereoVolume 的 映 
I — FE o 


@@ 即 使 不 是 实体 ， 我 们 也 需要 告诉 Hibernate 如 何 处 理 track 属 性 ， 
这 个 属性 会 引用 一 个 实体 。 如 有 果 没 有 这 个 标注 ， 试 图 构建 数据 库 模 式 
忠 会 失败 。 这 个 标注 也 让 我 们 能 够 保留 基于 XML 的 方法 中 使 用 同样 的 
列 名 称 。 美 中 不 足 的 是 ， 到 Track 类 的 级 联 请 求 还 不 足以 在 创建 新 专辑 
时 目 动 地 保存 曲目 ， 所 以 稍 后 我 们 将 需要 回 到 AlbumTest 类 的 早期 版 
本 。 在 本 章 的 7.3 市 中 ， 我 们 将 探究 一 种 能 够 重 狐 获 得 这 种 目 动 级 联 的 
模式 生成 方法 。 


人 @ 最 后 这 两 个 属性 表明 ， 在 使 用 标注 时 ， 有 时 你 根本 不 需要 提供 
任何 标注 。 虽 然 这 两 个 属性 声明 附近 什么 也 没有 ， 但 确实 能 够 被 映 
射 ， 标 注 处 理 器 提供 的 默认 处 理 可 以 实现 我 们 想 要 的 映射 。 


这 个 类 的 其 他 部 分 相当 直接 ， 比 其 他 几 个 例子 看 起 来 更 向 短 ， 因 
为 它 没 有 需要 管理 的 ID 属 性 ， 只 有 其 他 一 些 简 单 属性 。 


如 前 所 述 ， 这 段 代 码 中 的 映射 要 求 我 们 在 创建 新 的 专辑 时 ， 重 新 
负责 保存 曲目 对 象 。 例 5-13 中 Album.hbm.xml 最 终 的 映射 配置 不 需要 我 


们 负责 保存 曲目 ， 所 以 我 们 注释 抒 了 AlbumTest.java 的 addAlbumTrack 
() 中 调用 session.save (track) 的 那 行 代码 。 现 在 我 们 需要 取消 对 这 
行 的 注释 ， 这 样 才 会 与 例 5-8 保 持 一 致 。 


可 以 有 效 吗 


编辑 好 所 有 代码 后 ， 接 下 来 束 可 以 创建 数据 库 模 式 了 。 例 7-9 演 示 
了 我 们 现在 用 这 种 基于 标注 的 方法 ， 在 运行 ant schema 命 令 后 ， 得 到 的 
大 部 分 结果 。 其 中 ， 为 了 方便 阅读 ， 对 创建 表格 的 语句 行进 行 了 重新 
格式 化 。 


例 7-9: 使 用 标注 过 的 类 来 创建 数据 库 模 式 (重点 部 分 ) 


%ant schema 

Buildfile: build.xml 

Downloading: org/hibernate/hibernate- 
annotations/3.3.0.ga/hibernate-annotations- 

3.3.0.ga.pom@ 

Transferring 1K 

Downloading: org/hibernate/hibernate/3.2.1.ga/hibernate- 
3.2.1.ga.pom 

Transferring 3K 

Downloading: javax/persistence/persistence-api/1.0/persistence- 
api-1.0.pom 

Transferring 1K 

Downloading: org/hibernate/hibernate-commons- 
annotations/3.3.0.ga/hibernate-comm 

ons-annotations-3.3.0.ga.pom 

Transferring 1K 

Downloading: org/hibernate/hibernate- 
annotations/3.3.0.ga/hibernate-annotations- 

3.3.0.ga.jar 

Transferring 258K 


Downloading: javax/persistence/persistence-api/1.0/persistence- 
api-1.0.jar 

Transferring 50K 

Downloading: org/hibernate/hibernate-commons- 
annotations/3.3.0.ga/hibernate-comm 

ons-annotations-3.3.0.ga.jar 

Transferring 64K 

prepare: 

[copy]Copying 1 file to/Users/jim/svn/oreilly/hibernate/current/ 

examples/ch07/classes 

compile: 

[javac]Compiling 10 source files 
to/Users/jim/svn/oreilly/hibernate/ 

current/examples/ch07/classes 

schema: 

[hibernatetool]Executing Hibernate Tool with a Hibernate 
Annotation/EJB3 Config 

uration@ 

[hibernatetool]1.task: hbm2dd1 (Generates database schema) 

[hibernatetool]Jalter table ALBUM_ARTISTS drop constraint 
FK7BA403FCB99A6003; 

[hibernatetool]Jalter table TRACK_COMMENTS drop constraint 
FK105B2688E424525B; 

[hibernatetool]drop table ALBUM if exists; 

[hibernatetool]drop table TRACK_COMMENTS if exists; 

[hibernatetool]create table ALBUM (ALBUM_ID integer generated by 
default 

as identity (start with 1) , added date, numDiscs integer, 

TITLE varchar (255) not null, 

primary key (ALBUM_ID) ) ; © 

[hibernatetool]create table ALBUM_ARTISTS (ARTIST_ID integer not 
null, 

ALBUM_ID integer not null, 

primary key (ARTIST_ID, ALBUM_ID) ) ; 

[hibernatetool]create table ALBUM_COMMENTS (ALBUM_ID integer not 
null, 

COMMENT varchar (255) ) ; 

[hibernatetool]create table ALBUM_TRACKS (ALBUM_ID integer not 
null, 

disc integer, positionOnDisc integer, TRACK_ID integer, 

LIST_POS integer not null, 

primary key (ALBUM_ID, LIST_POS) ) ; 

[hibernatetool]create table ARTIST (ARTIST_ID integer generated 
by default 

as identity (start with 1) , NAME varchar (255) not null, 

actualArtist integer, 


primary key (ARTIST_ID) , unique (NAME) ) ; 
[hibernatetool]create table TRACK (TRACK_ID integer generated by 
default 


as identity (start with 1) , added date, 

filePath varchar (255) not null, playTime time, 
sourceMedia varchar (255) , TITLE varchar (255) not null, 
VOL_LEFT smallint, VOL_RIGHT smallint, 

primary key (TRACK_ID) ) ; 


[hibernatetool]create table TRACK_ARTISTS (ARTIST_ID integer not 
null, 


TRACK_ID integer not null, 
primary key (TRACK_ID, ARTIST_ID) ) ; 


[hibernatetool]create table TRACK_COMMENTS (TRACK_ID integer not 
null, 


COMMENT varchar (255) ) ; | 
[hibernatetool]create index ALBUM_TITLE on ALBUM (TITLE) ; 


[hibernatetool]Jalter table ALBUM_ARTISTS add constraint 
FK7BA403FCB99A6003 fore 


ign key (ARTIST_ID) references ALBUM; 


[hibernatetool]alter table TRACK_COMMENTS add constraint 
FK105B2688E424525B for 

eign key (TRACK_ID) references TRACK; 

[hibernatetool]9 errors occurred while performing<hbm2dd1>.® 


[hibernatetool]Error#1: java.sql.SQLException: Table not found: 
ALBUM_ARTISTS 


in statement[alter table ALBUM_ARTISTS] 


BUILD SUCCESSFUL 
Total time: 5 seconds 


@@ 因 为 这 是 我 们 第 一 次 要 求 Maven Ant Toolste Hibernate 
Annotations， 它 们 将 作为 依赖 而 目 动 下 载 。 


@ 这 里 你 可 以 看 到 ， 正 在 使 用 标注 来 驱动 数据 库 模 式 的 创建 。 


@ 如 果 同 例 5-7 中 的 相应 行进 行 比较 ， 你 会 发 现 虽然 显示 的 顺序 不 
同 ， 但 列 定义 是 完全 一 样 的 。ALBUM_ARTISTS、 


ALBUM_COMMENTS 以 及 最 具 挑 战 性 的 ALBUM_TRACKS 的 定义 都 


征 同 样 的 情况 。 我 们 已 经 成 功 地 用 标注 再 次 创建 了 原来 的 数据 库 模 
ae 


@ 在 创建 数据 库 模 式 ， 当 运行 时 根本 不 存在 数据 库 时 ， 束 会 看 到 
这 些 普通 的 错误 信息 。 这 些 错误 不 会 中 止 创建 过 程 ， 虽 然 有 错误 ， 但 


可 以 认为 创建 过 程 还 是 成 功 的 。 


同时 ， 你 可 以 在 本 半 目 录 下 运行 ant db 命令 ， 就 像 第 5 章 做 的 那 
样 ， 并 比较 一 下 它们 各 自生 成 的 数据 库 模 式 。 当 然 ， 看 看 实际 的 数 
据 ， 效 果 应 该 更 好 。 为 了 让 CreateTest.java 可 以 处 理 基 于 标注 的 映射 ， 
需要 修改 它 的 两 个 地 方 ， 如 例 7-10 所 示 。 我 们 需要 导入 Annotation- 
Configuration 类 ， 并 在 以 前 使 用 Configuration 类 的 位 置 使 用 它 。 


例 7-10: 对 测试 类 进行 调整 ， 以 处 理 基 于 标注 的 映射 


package com.oreilly.hh; 

import org.hibernate.’*; 

import org.hibernate.cfg.AnnotationConfiguration; 

import org.hibernate.cfg.Configuration; 

public static void main (String args[]) throws Exception{ 
//Create a configuration based on the annotations in our 
//model classes. 

Configuration config=new AnnotationConfiguration () ; 
config.configure () ; 


修改 完 后 ， 运 行 ant ctest 命 令 就 可 以 创建 示例 数据 ， 并 使 用 多 个 ant 
db 的 实例 ， 依 次 对 数据 进行 比较 。 


对 QueryTest.java、QueryTest2.java 以 及 AlbumTest.java 进 行 同 样 的 
修改 。 因 为 运行 ant qtest 和 ant qtest2 命 令 的 输出 与 前 一 章 相同 ， 这 里 就 
不 再 演示 了 。 但 是 我 们 想 演 示 来 自 AlbumTest 的 输出 内 容 ， 因 为 它 需 
依赖 整个 数据 库 模 式 ， 所 以 可 以 作为 一 个 不 错 的 完整 性 检查 。 用 它 也 
可 以 验证 例 7-8 后 面 介绍 的 那 行 用 于 保存 曲目 的 代码 确实 被 取消 注释 
T ° ffant atest， 对 我 们 这 个 基于 标注 的 数据 库 模 式 进行 测试 的 结果 
如 例 7-11 所 示 。 


例 7-11: 运行 AlbumTest， 测 试 标注 的 使 用 


atest: 

[java]com.oreilly.hh.data.Album@27d19d[title='Counterfeit 
e.p.'tracks='[ 

com.oreilly.hh.data.AlbumTrack@bf4c80[track='com.oreilly.hh.data 
. Track@2e3919[ 

title='Compulsion'volume='Volume[left=100, 
right=100] 'sourceMedia='CD']'], c 

om.oreilly.hh.data.AlbumTrack@3778cf[track='com.oreilly.hh.data. 
Track@f4d063[t 

itle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia= 

'CD']'], 
com.oreilly.hh.data.AlbumTrack@dc696e[track='com.oreilly.hh.data.Tr 
a 

ck@a5dac0[title='Smile in the Crowd'volume='Volume[left=100, 
right=100]'sourc 

eMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@8dbef1[track='com.oreilly.hh.d 

ata. Track@c4b579[title='Gone'volume='Volume[left=100, 
right=100] 'sourceMedia= 

'CD']'], 
com.oreilly.hh.data.AlbumTrack@f2f761[track='com.oreilly.hh.data.Tr 
a 

ck@8cd64[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, 

right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@4f1541[track= 


'com.oreilly.hh.data.Track@c042ba[title='Motherless 
Child'volume='Volume[left= 
100, right=100] 'sourceMedia='CD']']]'] 


除了 Java 随 机 将 类 加 载 到 的 内 存 地 址 不 同 以 外 ， 例 7-11 与 例 5-10 中 
看 到 的 输出 完全 相同 ， 和 我 们 希望 的 一 样 。 


注意 ;这 种 方法 能 行 ! 真 的 能 行 ! 


[1] 如 果 你 跳 过 本 书 前 面 的 内 容 直 接 阅 读 这 一 章 ， 那 么 最 好 回去 再 了 解 
一 下 用 到 的 这 些 类 和 它们 之 间 的 关系， 至少 要 浏览 一 下 从 第 3 章 开始 的 
内 容 ， 再 继续 学 习 。 这 样 你 的 收获 可 能 更 多 。 

[2] http://java.sun.com/javaee/technologies/persistence.jsp. 

[3] 变量 builder 是 方法 的 局 部 变量 ， 所 以 不 可 能 会 有 多 个 线程 同时 使 用 


Ea 


这 一 变量 。 


及 一 种 方法 


这 个 试验 表明 标注 确实 是 一 种 映射 模型 类 的 可 行 方法 。 通 过 为 数 
不 多 的 几 步 ， 我 们 束 可 以 精确 地 维护 前 面 草 市 中 逐步 建立 的 数据 库 模 
式 ， 只 是 标注 这 种 方法 不 能 让 我 们 在 创建 Album 时 级 联 创 建 Track 对 
象 。 如 果 以 稍微 不 同 的 方式 来 考虑 AlbumTrack 类 ， 则 还 有 另 一 种 方 
法 ， 让 我 们 在 数据 库 模 式 中 能 够 维护 这 种 目 动 的 级 联 处 理 ， 同 时 也 提 
供 了 一 些 其 他 功能 。 


将 AlbumTrack 映 射 为 一 个 完整 的 实体 ， 我 们 就 可 以 添加 级 联 标 
注 ，Hibernate 就 会 优先 处 理 Album 定 义 ， 以 嵌入 对 Track 的 引用 。 这 也 
给 我 们 带 来 一 些 新 的 需要 考虑 的 复杂 问题 ， 但 其 中 一 部 分 需要 视 不 同 
的 时 机 而 定夺 。 首 先 ， 将 AlbumTrack 作 为 实体 就 需要 具有 ID。 同 时 ， 
因为 我 们 接着 需要 不 从 Album 开 始 束 可 以 处 理 AlbumTrack 对 和 象 ， 所 以 
应 该 扩充 AlbumTrack 模 型 ， 以 提供 从 ALBUM_TRACKS 表 返回 到 
ALBUM 表 的 链接 (我 们 将 它 用 于 Hibernate 复 合 键 ) 。 为 此 ， 需 要 增 
加 一 个 album 属 性 。 例 7-12 演 示 了 AlbumTrack 了 映射 中 关键 的 一 部 分 ， 也 
是 这 种 方法 的 独特 之 处 所 在 。 


例 7-12: 将 AlbumTrack 类 标注 为 实体 


package com.oreilly.hh.data; 
import java.io.Serializable; 


import javax.persistence.*; 

@Entity® 

@Table (name="ALBUM_TRACKS") 

public class AlbumTrack{ 

@Ide@ 

@GeneratedValue (strategy=GenerationType.AUTO) 

private Integer id; 

@ManyToOne 

@JoinColumn (name="ALBUM_ID", insertable=false, updatable=false, 


nullable=false) 

private Album album; 

@ManyToOne (cascade=CascadeType.ALL) @ 
@JoinColumn (name="TRACK_ID", nullable=false) 
private Track track; 

public Integer getId () { 

return id; 


public void setId (Integer id) { 
this.id=id; 


} 
public Album getAlbum () { 
return album; 


} 
© 


public Track getTrack () { 


@ 明 显 地 ， 我 们 将 类 标注 由 @Embeddable 修 改 为 @Entity， 而 且 整 
在 这 里 选择 了 表 和 名， 而 不 是 在 Album 类 的 源 文 件 中 。 


@ 此 处 与 基于 XML 的 例子 中 的 模式 差别 最 大 。 以 前 我 们 的 
ALBUM_TRACK 表 使 用 一 个 复合 主键 ， 利 用 的 是 ALBUM_ID 和 
TRACK_ID 的 一 个 特定 组 合 在 数据 库 中 只 有 一 个 记录 这 一 事实 ， 这 样 
就 节省 了 我 们 在 ALBUM_TRACK 表 中 提供 一 个 单独 的 ID 列 的 需 


虽然 让 AlbumTrack 成 为 一 个 实体 后 还 保留 原来 的 数据 库 模式 也 是 
可 能 的 ， 不 过 这 需要 付出 不 少 的 努力 。JPA 要 求 所 有 的 复合 主键 部 要 
被 映射 为 一 个 单独 的 类 ， 由 这 个 类 来 提供 一 个 主键 的 各 个 成 员 。 所 
以 ,为 了 保留 原来 我 们 的 数据 库 模 式 ， 就 必须 对 模型 类 进行 比较 大 的 
修改 ， 只 是 为 了 持 有 AlbumTrack 类 的 主键 而 创建 一 个 新 的 类 。 


相反 ， 也 可 以 稍微 修改 一 下 数据 库 模 式 ， 为 ALBUM_TRACKS 增 
加 一 个 ID 列 (应 该 承认 ， 这 个 列 没有 什么 实际 用 途 ) ， 看 起 来 是 一 种 
破坏 力 比较 小 的 选择 。 无 论 如 何 ， 当 改变 映射 方法 时 ， 我 们 将 要 面 对 
各 种 权衡 ， 这 个 例子 就 是 一 个 有 趣 的 演示 。 


稀 到 Album 的 映射 是 我 们 以 前 见 过 的 @ManyIoOne， 但 是 还 需要 
提供 一 些 额外 的 参数 ， 才 能 让 它 按 我 们 想 要 的 方式 来 工作 。 这 段 “ 天 
语 ” 用 于 重新 创建 我 们 曾经 用 Album.hbm.xml 取 得 的 映射 效果 ， 让 
Hibernate 完 全 控制 对 ALBUM_TRACKS 表 的 ALBUM_ID 列 的 维护 。 如 
果 没 有 @JoinColumn 标 注 中 的 insertable 和 updatable 属 性 ， 我 们 就 得 必 
须 修 改 AlbumTest， 为 每 个 AlbumTrack 对 象 显 式 地 设置 album 属 性 ， 这 
样 也 就 意味 着 失去 了 一 些 我 们 想 要 从 Hibernate 得 到 的 自动 处 理 。 


当 使 用 实体 上 的 索引 映射 时 (具有 @IndexColumn 或 
@MapKey) ， 你 应 该 记 住 这 种 应 用 模式 。 


@ 有 既然 AlbumTrack 是 一 个 实体 ，Hibernate 束 能 够 为 它 的 track 属 性 
应 用 cascade 的 设置 。 


@ 我 们 可 以 强化 一 个 概念 ，Hibernate 在 管理 到 专辑 的 链接 (album 
属性 ) 时 ， 并 没有 使 用 setAlbum () 方法 。 


当然 ， 在 Album.java 中 这 一 关系 的 映射 方式 也 会 有 稍微 的 不 同 ， 
如 例 7-13 所 示 。 


例 7-13: Album.java 中 的 AlbumTracks 实 体 映 射 


@OneToMany (cascade=CascadeType.ALL) 
@IndexColumn (name="LIST_POS") 

@JoinColumn (name="ALBUM_ID", nullable=false) 
private List <AlbumTrack> tracks; 


@OneToMany 标 注 中 的 级 联 (cascade) 设置 ， 它 通过 Album 中 髓 
入 的 Track 引用 来 建立 这 种 完整 的 级 联 关 系 ， 我 们 在 例 5-13 开 发 的 
Album.hbm.xml 最 终 版 本 中 也 曾经 建立 过 这 样 的 关联 ， 在 那个 例子 中 
是 由 专辑 对 象 来 管理 它们 的 曲目 对 象 的 生命 周期 。 在 这 里 ， 需 要 再 一 
次 将 AlbumTest 的 addAlbumTrack () 方法 中 用 于 保存 曲目 的 那 行 代码 
注释 掉 。 这 样 ， 我 们 用 不 同 的 数据 库 模 式 重新 创建 了 原来 的 功能 。 如 
果 不 怕 麻烦 ， 也 可 以 创建 一 个 类 来 负责 管理 复合 键 ， 这 样 就 可 以 保留 
原来 的 功能 和 数据 库 模 式 。 


和 许多 其 他 Hibernate API 《以 及 一 般 的 面 癌 对 象 的 建 模 方 法 ) 一 
样 ， 可 以 用 多 种 方法 来 实现 一 个 功能 © 


HEA 


希望 这 一 章 可 以 让 你 对 如 何 用 标注 来 表达 数据 映射 有 个 大 致 的 了 
解 ， 也 和 希望 当 你 为 自己 的 项 目 探 索 新 的 选择 时 ， 本 章 介绍 的 内 容 可 以 
作为 一 个 民 好 的 起 点 。 在 本 书 接 下 来 的 部 分 ， 我 们 将 不 列举 相关 技术 
的 所 有 细节 和 功能 〈 这 应 该 是 Hibernate 参 考 手册 的 任务 ) ， 虽 然 有 时 
介绍 的 比较 肤浅 ， 但 希望 我 们 讨论 的 一 些 问题 可 以 作为 帮助 你 解决 模 
糊 问题 的 示例 。 如 果 所 有 办 法 都 解决 不 了 问题 ， 那 只 能 尝试 让 问题 重 
新 出 现 ， 再 将 错误 消息 粘贴 到 Google 上 搜索 ! 或 者 ， 如 果 你 是 好 “ 公 
民 *” 的 话 ， 可 以 研究 一 下 源 代 码 ， 将 问题 发 布 到 Hibermate 论 坛 上 以 寻求 
帮助 ， 把 解决 问题 的 希望 留 给 未 来 的 用 户 ， 并 帮助 突出 应 该 加 强 
Hibernate 文 档 的 哪些 部 分 。 


在 接 下 来 的 儿 章 中 ， 我 们 将 继续 回 到 基于 XML 的 世界 ， 看 看 儿 种 
查询 数据 的 方法 。 但 是 ， 还 应 该 记 住 标注 的 概念 ， 在 本 书 结尾 部 分 介 
绍 Spring 和 Stripes 的 章节 中 ， 将 会 再 次 用 到 和 它们。 


第 8 章 ”条 件 查询 


像 HQL (以 及 作为 它 的 基础 的 SQL) 这 样 的 关系 型 查询 语言 都 非 
常 灵 活 而 且 功 能 强大 ， 但 是 如 果 要 真正 精通 ， 也 得 花费 很 长 的 时 间 。 
很 多 应 用 程序 开发 人 员 对 SQL 只 有 基本 的 了 解 ， 只 能 根据 以 往 的 项 目 
模仿 些 相 似 的 示例 ， 当 碰 上 真正 没有 遇 到 过 的 或 是 非常 难以 理解 的 查 
询 表 达 式 时 ， 才 会 寻求 数据 库 专家 的 帮助 。</p> 


将 查询 语言 的 语法 和 Java 代 码 混杂 在 一 起 ， 也 很 麻烦 。 第 3.4 介 
绍 了 一 种 将 所 有 查询 语句 单独 放 在 男 一 个 文件 中 ， 可 以 集中 对 它们 进 
行 查 看 和 编辑 ， 不 需要 使 用 Java 字 符 串 转 义 字符 序列 (escape 
sequence) 和 串联 (concatenation) 语法 。 不 过 ， 即 使 采用 这 种 技巧 ， 
也 是 直到 加 载 映 射 文档 时 才 会 解析 HQL 查 询 语句 ， 也 就 是 说 ，HQL 碍 
询 内 容 中 隐藏 的 语法 错误 在 应 用 程序 运行 以 前 都 无 法 捕获 。 


Hibernate 采 用 条 件 查 询 的 方法 ， 为 这 些 问 题 提供 了 一 种 不 同 寻 和 
的 解决 方案 。 这 种 方法 通过 创建 商 单 的 Java 对 象 ， 并 把 它们 串 连 起 
来 ， 将 其 作为 过 滤 右 来 沛 选 出 你 想 要 的 结果 。 你 可 以 建立 舱 套 的 、 结 
构 化 的 表达 式 。 这 种 机 制 也 可 以 让 你 只 提供 示例 对 象 ， 以 表明 你 想 查 
找 的 内 容 是 什么 ， 同 时 还 能 控制 哪些 细 市 需要 关注 、 哪 些 属性 可 以 忽 
Hx o 


从 后 面 的 介绍 中 可 以 看 到 ， 这 种 功能 非常 方便 。 但 是 坦率 地 讲 ， 

它 也 有 自身 的 (非常 次 要 的 ) 缺点 。 把 见长 的 查询 表达 式 转换 成 Java 
API 会 占用 更 多 的 内 存 空间 ， 对 于 经 验 丰 富 的 数据 库 开发 人 员 而 言 ， 
他 们 对 条 件 查 询 不 像 对 类 SQL (SQL-like) 查询 语言 那么 熟悉 。 有 些 
东西 你 无 法 用 以 前 的 条 件 查 询 API 来 加 以 表达 ， 诸 如 投影 (从 一 个 类 
的 多 个 属性 中 取出 子 集 ， 例 如 "select title, id from 
com.oreilly.hh.Track"， 而 不 是 "select*from com.oreilly.hh.Track") #1% 
合 (aggregation) (对 查询 结果 做 统计 总 结 ， 例 如 获取 某 个 属性 的 总 
和 、 平 均值 以 及 总 数 ) 。 这 种 非常 严重 的 不 足 ， 在 编写 本 书 第 1 版 时 
API 就 存在 ， 不 过 ， 在 Hibernate 3 中 已 经 得 到 了 解决 。 我 们 会 向 你 介绍 
现在 应 该 怎么 实现 这 些 条 件 查 询 。 下 一 章 还 会 演示 如 何 使 用 Hibernate 
的 面向 对 象 的 查询 语言 (HQL) 来 完成 此 类 任务 。 


不 论 使 用 哪 一 种 Hibernate 的 方法 来 表达 查询 ， 最 终 都 会 生成 特定 
数据 库 的 SQL 语 句 ， 由 SQL 来 实现 查询 目的 。 所 幸 ， 你 不 会 看 到 这 些 
底层 细节 ， 但 是 ， 如 果 你 对 这 些 细节 感 兴趣 的 话 ， 可 以 使 用 Hibernate 
配置 文件 的 show_sql 属 性 打开 SQL 日 志 输 出 (如 例 3-1 所 示 ) ， 或 是 在 
Eclipse 中 使 用 交互 式 的 SQL 查 询 预览 (将 在 第 11 章 介绍 ) 。 


fE HEREA 


我 们 先 建 一 个 条 件 查 询 来 查找 播放 时 间 少 于 指定 长 度 的 曲目 ， 将 
例 3-11 中 所 用 的 HQL 礁 换 挤 ， 并 更 新 例 3-12 的 代码 。 


应 该 怎么 做 


需要 明白 的 第 一 件 事 就 是 如 何 指定 我 们 想 要 检索 的 对 象 的 类 型 。 
在 建立 条 件 查 询 时 ， 不 会 涉及 任何 查询 语言 。 相 反 ， 你 得 构建 一 个 由 
Criteria 对 象 组 成 的 树 状 结构 来 描述 你 需要 检索 的 对 象 。Hibernate 
Session 就 是 创建 这 些 Criteria 对 象 的 工厂 ， 而 你 需要 做 的 就 是 指定 想 要 
检索 到 的 对 象 的 类 型 ， 够 方便 的 吧 。 


编辑 QueryTest,java， 将 tracksNoLongerThan () 方法 的 内 容 替 换 
成 例 8-1 所 示 的 内 容 。 


注意 : 这些 示例 假设 已 经 按照 前 儿 半 所 壕 建 六 好 了 数据 库 。 如 果 
你 不 想 从 头 开始 ， 就 下 载 示 例 代 码 ， 然 后 再 跳 到 这 一 革 的 目录 ， 运 行 
codegen、schema、 以 及 ctest 这 几 个 构建 目标 。 即 使 你 按照 书 中 介绍 一 
路 走 来 ， 运 行 schema 和 ctest 也 将 确保 生成 这 些 示 例 展 示 的 数据 。 


例 8-1: 条 件 查询 入 门 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

return criteria.list () ; 


会 话 对 象 的 createCriteria () 方法 会 创建 一 个 条 件 查询 对 象 
(Criteria 类 的 实例 ) ， 由 它 返 回 作为 参数 传递 给 它 的 持久 化 类 的 所 有 
实例 ， 真 够 侧 音 的。 当然， 如 采 现 在 运行 示例 ， 会 看 到 数据 库 中 保存 
的 所 有 曲目 ， 因 为 我 们 还 没有 使 用 任何 查询 条 件 (criteria) 来 限制 查 
询 结 果 (如 例 8-2 所 示 ) ° 


例 8-2: 羽 凤 未 丰 的 条 件 查 询 将 返回 所 有 曲目 


%ant qtest 
qtest: 
java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
J p 
[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 
from VHS Videocassette tape 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 
Disc 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 
William Orbit, Samuel Barber) 00: 06: 35, from Compact Disc 
java]Track: "Adagio for Strings (ATB Remix) " (William Orbit, 
J 9 9 
ATB， 
Samuel Barber) 00: 07: 39, from Compact Disc 
[java]Track: "The World'99" (Ferry Corsten, Pulp Victim) 00: 07: 
05, 
from Digital Audio Stream 
java]Track: "Test Tone 1"00: 00: 10 
J 
java]Comment: Pink noise to test equalization 
J q 


OF, KRE ABA, DAE Apa TY A? 也 很 简 
单 ! 只 要 在 源 文 件 顶端 新 增加 一 行 


import org.hibernate.criterion. * 


然后 ， 再 在 这 个 方法 中 痢 增 加 一 行 ， 如 例 8-3 所 示 。 
例 8-3: 用 Criteria 查 询 完全 取代 第 3 章 使 用 的 HQL 碍 询 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.le ("playTime", length) ) ; 

return criteria.list 


注意 : 就 像 HQL 那 样 ， 表 达 式 总 是 以 对 象 属性 来 表示 ， 而 不 使 用 
数据 表 的 字段 。 


Restrictions 类 是 一 个 工厂 类 ， 用 于 获取 在 查询 中 指定 各 种 约束 条 
件 的 Criterion 实 例 。 它 的 le O 方法 会 创建 一 个 Criterion 对 象 ， 限 制 一 
个 属性 必须 小 于 或 等 于 指定 的 值 。 在 这 个 例子 中 ， 我 们 想 让 Track 的 
playTime 属 性 不 大 于 传递 给 该 方法 的 值 。 最 后 再 把 它 添 加 到 所 要 的 条 
件 查 询 组 合 中 。 下 一 节 我 们 将 会 看 到 其 他 几 个 通过 Restrictions 能 用 的 
Criterion 类 型 。 附 如 B 会 列 出 全 部 的 Criterion 类 型 ， 如 采 你 想 文 持 新 的 
条 件 形式 ， 也 可 以 目 行 创建 Criterion 接 口 的 实现 。 


这 次 运行 查询 时 ， 会 得 到 长 度 不 超过 7 分 钟 的 曲目 ， 如 例 8-4 所 


例 8-4: 完整 的 位 单条 件 查 询 的 结 


%ant qtest 
qtest: 
java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
J p 
[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 
from VHS Videocassette tape 
[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact Disc 
[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 
Samuel Barber, William Orbit) 00: 06: 35, from Compact Disc 
java]Track: "Test Tone 1"00: 00: 10 
J 
java|]Comment: Pink noise to test equalization 
J q 


注意 : 本 书 新 版 修订 了 这 个 示例 ，"Adagio for Strings'2 iTunes 
中 随机 开始 播放 。 


在 实际 应 用 中 ， 绝 大 多 数 用 于 检索 对 象 的 查询 都 是 非常 简单 的 ， 
而 条 件 查询 更 是 用 Java 表 达 这 些 查询 时 极为 自然 和 简洁 的 方式 。 新 的 
tracksNoLongerThan () 方法 实际 上 比例 3-12 和 那个 需要 将 查询 添加 到 
映射 文件 的 示例 ( 例 3-11) 还 要 短 ! 不 过 ， 它 们 最 终 都 以 相同 的 模式 
来 访问 底层 数据 库 ， 所 以 运行 效率 相当 。 


不 过 ， 如 果 需 要 的 话 ， 也 可 以 把 代码 写 得 更 紧凑 些 。Add () 和 
createCriteria () 方法 会 返回 Criteria 实 例 ， 所 以 可 以 在 同一 Java 语 句 中 
连续 操作 该 实例 。 利 用 这 一 点 ， 我 们 就 能 把 这 个 方法 再 归纳 一 下 ， 
成 例 8-5 的 样子 。 


例 8-5: 更 为 紧 凌 的 条 件 查询 


public static List tracksNoLongerThan (Time length, Session 
session) { 

return session.createCriteria (Track.class) . 

add (Restrictions.le ("playTime", length) ) .list () ; 

} 


选择 编码 风格 束 是 在 空间 和 可 读 性 之 间 做 出 取舍 (不 过 ， 有 些 人 
会 觉得 这 种 紧凑 、 连 续 编 码 的 版 本 更 具 可 读 性 ) o 


其 他 


对 结果 进行 排序 ? 从 所 有 匹配 的 对 象 中 取 回 它们 的 一 部 分 ? 和 
Query 接 口 一 样 ，Criteria 接 口 也 可 以 让 你 调用 setMaxResults () 7 
setFirstResult () 方法 来 限制 取 回 的 结果 数目 (以 及 选择 从 哪里 开 
始 ) 。 此 外 ， 这 个 接口 也 可 以 让 你 控制 结果 返回 的 顺序 (在 HQL 查 询 
中 ， 则 是 使 用 order by 子 句 ) ， 如 例 8-6 所 示 。 


例 8-6: 按照 标题 对 结果 进行 排序 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.le ("playTime", length) ) ; 

criteria.addOrder (Order.asc ("title") .ignoreCase () ) ; 

return criteria.list () ; 


Order 类 只 是 表达 排列 顺序 的 一 种 方式 。 它 有 两 个 静态 的 工厂 方 
法 : asc () 和 desc () 方法 ， 分 别 用 于 创建 升序 和 降序 的 排列 。 每 个 


方法 都 以 要 排序 的 属性 名 称 作 为 参数 。 如 采 调 用 Order 实 例 的 
ignoreCase () 方法 ， 则 排序 将 不 区 分 字母 的 大 小 写 ， 这 经 常 是 你 想 要 
的 显示 方式 。 运 行 这 个 版 本 的 示例 ， 其 结 末 如 例 8-7 所 示 。 


例 8-7， 对 检索 结 采 进行 排序 


%ant qtest 

qtest: 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 

Samuel Barber, William Orbit) 00: 06: 35, from Compact Disc 


[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 


Disc 

[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
[java]Track: "Test Tone 1"00: 00: 10 

[java]Comment: Pink noise to test equalization 


[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 


from VHS Videocassette tape 


可 以 在 Criteria 添 加 多 个 Order， 这 样 Criteria 束 会 按 每 个 Order 的 先 
后 进行 排序 ( 先 按 第 一 个 Order 排 序 ， 如 果 有 任何 查询 结果 与 那个 属性 
具有 相同 的 值 ， 就 再 按 第 二 个 Order 进 行 排 序 ， 依 此 类 推 ) 。 


可 以 想到 ， 如 果 在 查询 中 添加 多 个 Criterion， 那 么 结果 中 的 对 象 
就 得 满足 所 有 的 Criterion。 这 相当 于 使 用 Restrictions.conjunction () 建 
六 一 个 组 合 条件 ， 详 情 可 以 参阅 附录 B。 就 例 8-8 来 说 ， 我 们 可 以 限制 
查询 结果 ， 所 以 在 该 方法 中 男 加 一 行使 得 曲目 的 标题 中 必须 包 
BPAY 


例 8-8: 一 个 较 挑 吻 的 条 件 查 询 


Criteria criteria=session.createCriteria (Track.class) ; 
criteria.add (Restrictions.le ("playTime", length) ) ; 


criteria.add (Restrictions.like ("title", "%A%") ps, 
criteria.addOrder (Order.asc ("title") .ignoreCase () ) ; 
return criteria.list () : 


准备 好 以 后 ， 运 行程 序 ， 这 次 会 得 到 较 少 的 结果 ， 如 例 8-9 所 示 。 


例 8-9: 播放 时 间 等 于 或 少 于 7 分 钟 旦 标题 包含 字母 "A" 的 曲目 


qtest: 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Samuel 
Barber, 

Ferry Corsten, William Orbit) 00: 06: 35, from Compact Disc 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 

Compact Disc 


如 果 你 不 记得 (或 不 知道 ) 像 这 样 的 SQL“%" 字 符 串 匹配 的 语 
法 ，Hibernate 还 提供 了 一 个 可 供 调用 的 参数 变量 ， 用 于 在 Java 中 表达 
你 需要 的 任何 匹配 。 就 这 个 例子 来 说 ， 可 以 写成 Restrictions.like 
("title", "A", MatchMode.ANYWHERE) 。 如 果 你 想 进 行 区 分 大 小 
写 的 匹配 ， 应 该 使 用 ilike， 而 不 是 like。 


如 果 你 希望 找 出 满足 任意 条 件 之 一 的 对 象 ， 而 非 满足 所 有 条 件 的 
对 象 ， 就 得 显 式 的 使 用 Restrictions.disjunction () 将 这 些 条 件 分 组 。 可 
以 使 用 Restrictions 类 提供 的 Criteria 工 厂 来 建立 这 些 分 组 以 及 其 他 复杂 
层次 的 组 合 。 详 情 可 以 参阅 附 孙 B。 例 8-10 演 示 了 我 们 对 示例 查询 的 修 
改 ， 让 返回 的 曲目 既 满 足 时 间 长 度 限制 义 满足 标题 包含 大 写字 母 A。 


注意 : 条 件 查询 结合 了 强大 的 功能 和 方便 性 ， 令 人 吃惊 。 
例 8-10: 限制 较 宽 松 的 条 件 查 询 


Criteria criteria=session.createCriteria (Track.class) ; 
Disjunction any=Restrictions.disjunction () 

any.add (Restrictions.le ("playTime", length) ) ; 

any.add (Restrictions.like ("title", "%A%") ) ; 
criteria.add (any) ; 

criteria.addOrder (Order.asc ("title") .ignoreCase () ) ; 
return criteria.list 


这 会 让 我 们 多 获取 一 个 新 的 "Adagio for Strings" HHA 《如 例 8-11 所 


例 8-11: 标题 舍 有 字母 "A" 或 者 时 间 不 超过 7 分 钟 的 曲目 


qtest: 


[java]Track: "Adagio for Strings (ATB Remix) " (ATB, William 
Orbit, 


Samuel Barber) 00: 07: 39, from Compact Disc 


[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Ferry 
Corsten, 


William Orbit, Samuel Barber) 00: 06: 35, from Compact Disc 


[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 


Disc 

[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 
[java]Track: "Test Tone 1"00: 00: 10 

[java]Comment: Pink noise to test equalization 


[java]Track: "Video Killed the Radio Star" (The Buggles) 00: 03: 
49, 


from VHS Videocassette Tape 


后 要 注意 的 是 ， 把 这 个 方法 精简 到 一 个 表达 式 也 是 可 行 的 (如 
例 8-12 所 示 ) 。 这 得 多 亏 这 些 方 法 的 设计 精巧 的 返回 值 。 


例 8-12: 代码 精简 得 有 些 过 头 


return session.createCriteria (Track.class) .add 
(Restrictions.disjunction () . 

add (Restrictions.le ("playTime", length) ) . 

add (Restrictions.like ("title", "%A%") ) ) . 

addOrder (Order.asc ("title") .ignoreCase () ) .list () ; 


虽然 得 到 的 结果 都 一 样 ， 但 我 觉得 你 也 会 认为 这 样 做 对 该 方法 代 
码 的 可 读 性 没有 什么 帮助 (可 能 LISP 专 家 不 算 在 内 吧 ) |! 


可 以 用 Restrictions 提 供 的 工具 来 建立 各 种 各 样 的 多 重 条 件 。 有 些 
情况 还 得 需要 HQL， 而 且 超 过 一 定 的 复杂 上 度 的 话 ， 可 能 还 是 用 HQL 比 
较 好 。 但 是 ， 条 件 查 询 能 够 让 你 做 很 多 事情 ， 这 常常 是 正确 的 做 法 。 
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如 果 你 对 SQL 比较 熟悉 ， 那 么 应 该 明白 本 节 标 题 的 意思 。 如 果 不 
明日 的 话 ， 也 不 要 担心 ， 它 们 其 实 相 当 人 简单 。 投 影 只 十 说 ， 你 并 不 是 
需要 一 个 表 中 的 所 有 信息 ， 而 是 只 需要 其 中 的 一 部 分 。 在 像 Hibernate 
这 样 的 面向 对 象 的 环境 中 ， 投 影 束 古 指 不 必 检 索 回 一 个 完整 的 对 象 ， 
只 需要 对 象 的 一 两 个 属性 。 聚 合 殴 是 标识 一 些 属性 ， 并 计算 针对 这 些 
属性 的 统计 信息 ， 例 如 计算 总 和 、 最 大 值 、 最 小 值 以 及 平均 值 。 


在 Hibernate 3 以 前 ， 不 使 用 HQL 束 没 办 法 进行 这 样 的 操作 ， 所 以 
这 征 Hibernate 3 对 Criteria API 的 一 个 很 好 的 扩展 。 我 们 先 来 看 看 一 些 
示例 。 先 来 个 位 单 的 例子 ， 假 设 我 们 想 打 印 所 有 标题 包含 字母 "v" 的 曲 
目的 标题 ， 但 不 必 加 载 任何 一 个 完整 的 Track 对 象 。 


应 该 怎么 做 


例 8-13 演 示 了 一 个 方法 ， 它 使 用 Criteria API 提 供 的 投影 功能 来 实 
现 这 一 目的 。 


例 8-13: 对 单一 属性 的 价 单 投影 


*Retrieve the titles of any tracks that contain a particular 
text string. 
* 


*@param text the text to be matched, ignoring case, anywhere in 
the title. 

*@param session the Hibernate session that can retrieve data. 

*@return the matching titles, as strings. 

ah 

public static List titlesContainingText (String text, Session 
session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.like ("title", text, 
MatchMode.ANYWHERE) .@ 

ignoreCase () ) ; 

criteria.setProjection (Projections.property ("title") ) ; @ 

return criteria.list () ; 


} 


@ 这 行 演示 了 使 用 MatchMode 接 口 来 避免 执行 字符 串 处 理 ， 也 不 
用 为 了 指定 想 要 的 字符 串 匹 配 模式 而 记 住 特定 的 “%?” 字 符 的 用 法 。 


@ 这 里 使 用 Projections 类 来 告诉 criteria， 我 们 想 要 进行 一 个 投影 控 
作 ， 我 们 对 取 回 找到 的 曲目 的 title 属 性 特别 感 兴趣 。 


像 我 们 的 其 他 条 件 查询 一 样 ， 这 个 方法 返回 的 也 是 一 个 List 对 
象 。 但 是 确切 地 说 ， 到 撒 是 什么 内 容 的 列表 呢 ? Criteria 征 在 Track 类 的 
基础 上 创建 的 ， 但 是 由 于 我 们 只 需要 检索 回 曲目 的 标题 属性 ， 所 以 构 
造 并 返回 整个 Track 对 象 并 没有 多 大 意义 。 事 实 上 ， 在 这 种 情况 下 ， 只 
要 将 整个 对 象 投 影 到 一 个 属性 ， 吏 可 以 得 到 与 该 属性 相关 联 的 类 型 的 
一 个 列表 。 在 这 个 例子 中 ， 因 为 它 是 一 个 字符 串 属 性 ， 所 以 得 到 的 吏 
是 一 个 包含 String 实 例 的 List 对 象 。 


这 样 做 确实 有 意义 ! 


为 了 检 难 效果 ， 可 以 将 这 个 方法 添加 到 QueryTest.java 中 ， 修 改 
main () 函数 以 调用 它 ， 如 下 所 示 : 


System.out.printin (titlesContainingText ("v", session) ) ; 
运行 这 个 版 本 的 程序 ， 将 产生 以 下 输出 : 

qtest: 

[java][Video Killed the Radio Star, Gravity's Angel] 


很 显然 ， 通 过 投影 也 可 以 检索 回 那 些 不 在 Restrictions 表 达 式 中 的 
各 属性 。 如 果 我 们 想得到 曲目 长 度 ， 可 以 这 样 做 : 


criteria.setProjection (Projections.property ("playTime") ) ; 


它 的 输出 结果 是 : 


qtest: 
[java][00: 03: 49, 00: 06: 06] 


当然 ， 方 法 名 称 看 起 来 好 像 不 对 ， 输 出 结果 也 不 明了 。 如 果 我 们 
既 想 取 回 标题 ， 也 想 取 回 长 度 ， 那 该 怎么 办 ? 其 实 也 很 简单 ， 如 例 8- 
14 所 示 。 


例 8-14: 投影 到 两 个 属性 


fue 
*Retrieve the titles and play times of any tracks that contain a 
*particular text string. 


* 


*@param text the text to be matched, ignoring case, anywhere in 
the title. 

*@param session the Hibernate session that can retrieve data. 

*@return the matching titles and times wrapped in object arrays. 

*/ 

public static List titlesContainingTextWithPlayTimes (String 
text, 

Session session) { 

Criteria criteria=session.createCriteria (Track.class) ; 

criteria.add (Restrictions.like ("title", text, 
MatchMode . ANYWHERE) 

.ignoreCase () ) ; 

criteria.setProjection (Projections.projectionList () .@ 

add (Projections.property ("title") ) .@ 

add (Projections.property ("playTime") ) ) ; 

return criteria.list () ; 


} 


@projectionList () 方法 创建 一 个 ProjectionList 实 例 ， 它 可 以 包含 
应 用 于 一 个 条 件 碍 询 的 多 个 投影 选择 。 注 意 ， 我 们 正在 使 用 的 是 例 8-5 
介绍 的 简洁 的 链 式 标记 法 ， 这 样 束 不 需要 再 声明 一 个 变量 来 持 有 这 
实例 了 。 


@@ 接 着 ， 我 们 只 要 将 所 有 需要 的 投影 添加 到 ProjectionList， 再 将 
这 个 ProjectionList 实 例 传 递 给 条 件 查询 对 象 的 setProjection () 方法 。 


这 里 最 不 容易 处 理 的 钙 从 查询 返回 的 结果 。 和 前 面 的 一 样 ， 它 也 
征 一 个 List， 但 现在 每 个 列表 元 聚 要 包 侣 多 个 值 ， 而 且 这 些 值 的 类 型 
还 可 能 不 同 。Hibernate 采 用 的 办 法 是 返回 一 个 对 象 数组 的 列表 。 以 下 

这 段 代码 用 于 显示 返回 的 列表 ， 看 起 来 有 些 复杂 : 


for (Object o: titlesContainingTextwithPlayTimes ("v", session) ) 


Object[]Jarray= (Object[]) o 
System.out.println ("Title: "+array[0]+ 
" (Play Time: "tarray[1]+') ') ; 

} 


它 将 输出 以 下 内 容 : 


qtest: 
[java]Title: Video Killed the Radio Star (Play Time: 00: 03: 49) 
[java]Title: Gravity's Angel (Play Time: 00: 06: 06) 
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式 来 使 用 投影 。 对 象 /关系 映射 系统 的 要 点 就 是 你 可 以 只 返回 对 象 ， 在 
需要 一 些 属性 有 时， 再 用 这 些 对 象 来 得 到 你 要 的 属性 。 这 样 的话 ， 为 什 
么 投影 要 文 持 多 个 值 ? 咽 ， 事 实 上 古 存 在 好 的 理由 的 ， 它 与 我 们 在 本 市 

开始 介绍 的 “聚合 ”的 概念 有 关 。 很 多 时 候 在 使 用 投影 时 ， 经 常会 得 到 
原来 根本 不 直接 属于 任何 对 象 的 值 ， 只 是 这 些 值 会 基于 某 些 对 象 的 属 
性 。 例 8-15 演 示 了 一 个 方法 ， 它 会 输出 数据 库 中 的 每 种 曲目 来 源 媒 

， 以 及 来 目 这 种 媒介 的 所 有 曲目 的 数量 ， 还 有 这 种 媒介 的 曲目 的 最 

长 播放 时 间 。 


例 8-15: 带 有 聚合 的 投影 


SER 
*Print statistics about various media types. 
* 


*@param session the Hibernate session that can retrieve data. 
*/ 


public static void printMediaStatistics (Session session) { 
Criteria criteria=session.createCriteria (Track.class) ; 
criteria.setProjection (Projections.projectionList () .@ 
add (Projections.groupProperty ("sourceMedia") ) .® 

add (Projections.rowCount () ) .® 

add (Projections.max ("playTime") ) ) ; © 

for (Object o: criteria.list () ) {® 

Object[]Jarray= (Object[]) o 

System.out.println (array[0]+"track count: "+array[1]+ 

", max play time: "+array[2]) 


} 
注意 : 现在 我 们 正在 利用 数据 库 的 功能 做 些 很 有 意思 的 事 ! 
这 个 例子 涉及 我 们 目前 为 止 见 到 的 许多 事情 : 


@@ 和 以 前 一 样 ， 我 们 正在 创建 一 个 ProjectionList 实 例 来 持 有 想 要 
查询 返回 的 各 个 项 。 


@groupProperty () 方法 与 我 们 目前 使 用 过 的 property O 方法 类 
似 ， 但 它 是 告诉 Hibernate 将 指定 的 属性 对 记录 进行 分 组 ， 所 有 值 相 同 
的 记录 就 成 为 结果 集中 的 一 条 记录 。 分 组 是 执行 罕 合 操作 的 关键 ， 外 
让 我 们 为 投影 增加 聚合 值 。 


@rowCount () 投影 不 需要 任何 参数 ， 因 为 它 只 是 返回 分 组 到 当 
前 结果 集中 的 记录 的 总 数 (基于 我 们 的 groupProperty () AME, 
sourceMedia) 。 这 就 是 我 们 计算 属于 每 种 来 源 媒介 类 型 的 曲目 数量 的 
HIRS 


Omax () 投影 返回 分 组 的 结果 集中 某 个 属性 的 最 大 值 。 


@ 最 后 ， 我 们 用 类 似 前 面 例子 中 创建 的 输出 循环 ， 循 环 遍历 条 件 
查询 返回 的 Object 数组 的 List， 并 输出 它们 。 


在 QueryTest.java 的 main () 函数 中 调用 这 个 方法 很 简单 : 
printMediaStatistics (session) ; 
它 会 生成 以 下 输出 : 


qtest: 

[java]CD track count: 4; max play time: 00: 07: 39 
[java]VHS track count: 1; max play time: 00: 03: 49 
[java]STREAM track count: 1; max play time: 00: 07: 05 
[java]null track count: 1; max play time: 00: 00: 10 


这 一 结果 应 该 会 让 你 对 投影 和 聚合 的 真正 价值 有 所 了 解 (null 煤 
介 类 型 供 我 们 测试 使 用 ) 


不 过 ， 能 够 看 到 ， 这 一 输出 并 没有 按 任何 顺序 进行 排序 。 我 们 可 
能 想 进 行 排序 ， 但 是 你 怎么 对 投影 结果 排序 呢 ? 答案 就 是 我 们 需要 看 
看 Criteria API 中 的 男 一 个 改进 。 你 可 以 为 对 象 和 属性 分 配 “ 别 名 ”， 以 
供 我 们 处 理 使 用 (就 像 在 数据 库 查 询 语言 中 为 表 和 列 起 的 别名 一 
样 ) ， 而 不 论 它 们 是 直接 来 自 数据 库 ， 还 是 来 自 投影 和 聚合 操作 。 这 
样 ， 我 们 按照 来 源 媒介 进行 排序 束 容 易 了 ， 只 需要 为 分 组 后 的 属性 添 
加 一 个 别名 : 


add (Projections.groupProperty ("sourceMedia") .as ("media") ) . 


这 条 语句 声明 了 一 个 "media" 别 名 ， 接 着 束 可 以 通 一 别名 进行 
排序 ， 就 像 我 们 前 面 对 普通 的 对 象 属性 进行 排序 一 样 : 


criteria.addOrder (Order.asc ("media") ) ; 


YA 


经 过 这 些 变化 后 ， 我 们 束 可 以 看 到 排序 后 的 输出 内 容 : 


qtest: 


[java]null track count: 1; max play time: 00: 00: 10 
[java]CD track count: 4; max play time: 00: 07: 39 
[java]STREAM track count: 1; max play time: 00: 07: 05 
[java]VHS track count: 1; max play time: 00: 03: 49 


之 所 以 使 用 别名 还 有 些 其 他 原因 ， 使 用 投影 也 还 可 以 完成 更 多 的 
事情 ， 但 是 接 下 来 要 介绍 条 件 查 询 的 其 他 方面 。 在 本 章 最 后 ， 我 们 将 
介绍 到 哪里 可 以 学 习 到 更 多 的 相关 内 容 。 


在 关联 中 应 用 条 件 碍 询 


到 目前 为 止 ， 在 条 件 查 询 的 构建 上 ， 我 们 看 到 的 都 是 查询 同一 个 
类 的 各 种 属性 。 当 然 ， 在 真实 的 系统 中 ， 对 象 之 间 有 丰富 的 关联 关 
系 。 有 时 ， 我 们 想 用 于 过 滤 结 果 的 细节 是 来 源 于 这 些 关 联 。 幸 好， 条 
件 查询 API 提 供 了 一 种 相当 简明 的 方式 可 以 执行 这 样 的 搜索 。 


应 该 怎么 做 


假设 我 们 想 找 出 与 特定 乙 人 相关 联 的 所 有 曲目 。 我 们 需要 的 查询 
束 古 检查 每 个 Track 对 和 象 的 artists 属 性 中 包含 的 值 。artists 属 性 是 一 个 集 
合 ， 包 含 与 某 个 曲目 相关 的 所 有 Artist 对 象 的 关联 。 为 了 让 查询 过 程 更 
有 趣 些 ， 再 假设 我 们 想 找 到 姓名 属性 匹配 特定 子 字符 串 (substring) 
的 艺人 相关 联 的 所 有 曲目 。 


我 们 在 QueryTestjava 里 新 增加 一 个 方法 来 实现 这 一 功能 。 新 增 的 
方法 如 例 8-16 所 示 ， 隋 放 在 tracksNoLongerThan () 方法 之 后 。 


例 8-16: ta ZA ROR WE HH H 


/** 

*Retrieve any tracks associated with artists whose name matches 
a SQL 

*string pattern. 

* 


*@param namePattern the pattern which an artist's name must 
match 

*@param session the Hibernate session that can retrieve data. 

*@return a list of{@link Track}s meeting the artist name 
restriction. 

*/ 

public static List trackswithArtistLike (String namePattern, 
Session session) 


{ 

Criteria criteria=session.createCriteria (Track.class) ; 
Criteria artistCriteria=criteria.createCriteria ("artists") ; @ 
artistCriteria.add (Restrictions.like ("name", namePattern) ) ; @ 
artistCriteria.addOrder (Order.asc ("name") .ignoreCase () ) ; © 
return criteria.list () ; 


@@ 前 面 开始 的 代码 看 起 来 很 熟悉 ， 这 一 行 接着 再 用 曲目 对 象 的 
artists 属 性 ， 又 创建 了 一 个 Criteria 实 例 ， 附 加 到 我 们 用 于 选择 曲目 的 那 
个 Criteria 实 例 上 。 这 意味 着 我 们 或 者 可 以 增加 约束 到 criteria 上 (应 用 
到 Track 自身 的 属性 ) ， 或 者 加 到 artistCriteria 上 (应 用 到 与 曲目 关联 的 
Artist 实 体 的 属性 ) 。 


@ 在 这 个 例子 中 ， 我 们 只 对 乞 人 的 信息 感 兴趣 ， 所 以 我 们 将 结果 
限制 为 与 艺人 相关 联 的 曲目 ， 这 些 曲 目的 世人 中 至 少 要 有 一 个 艺人 的 
名 称 必须 匹配 指定 的 模式 (再 一 次 ， 通 过 将 约束 应 用 到 两 个 Criteria 实 
例 上 ， 我 们 就 能 够 同时 限制 Track 和 Artist 的 属性 ) 。 


注意 : 最终， 在 本 书 的 这 一 版 本 中 ， 能 够 看 到 我 原本 期 望 已 久 的 
输出 结果 。 


自我 们 要 求 按 艺人 的 名 字 排 序 。 编 写本 书 第 1 版 时 ， 与 当时 可 以 使 
用 的 只 有 尝试 性 质 的 Criteria API 相 比 ， 这 是 Hibernate3 带 来 的 又 一 个 改 
进 。 原 来 只 能 够 对 最 外 层 的 条 件 查询 进行 排序 ， 但 不 能 对 为 关联 而 创 
建 的 子 条 件 查 询 进行 排序 。 如 果 试 图 这 么 做 ， 就 会 得 到 一 个 


UnsupportedOperationException ° 


为 了 看 到 这 一 查询 的 执行 结果 ， 我 们 还 得 做 个 修改 。 修 改 main 
O 方法， 让 它 调 用 这 个 新 查询 ， 如 例 8-17 所 示 。 


例 8-17: 调用 新 的 曲目 亏 人 姓名 查询 


//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 

try{ 

//Print tracks associated with an artist whose name ends with"n" 
List tracks=trackswithArtistLike ("%n", session) ; 

for (ListIterator iter=tracks.listIterator () ; 


现在 执行 ant qtest， 可 以 得 到 例 8-18 所 示 的 结果 。 
例 8-18: SWE DF ak "ABZ PERERA ATH H 


qtest: 

[java]Track: "The World'99" (Pulp Victim, Ferry Corsten) 00: 07: 
05, 

from Digital Audio Stream 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (William 
Orbit, 

Samuel Barber, Ferry Corsten) 00: 06: 35, from Compact Disc 


[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 
Compact 
Disc 


AT AT A 


注意 : 你 也 可 以 为 用 到 的 关联 建立 别名 ， 并 在 表达 式 中 使 用 。 这 
会 让 情形 变 得 更 复 淋 ,但 是 有 用 。 改 天 人 研究 一 下 吧 。 


如 果 查 看 这 三 个 曲目 的 艺人 列表 ， 就 会 发 现 每 个 曲目 的 艺人 姓名 

中 至 少 有 一 个 以 "n" 结 尾 ， 符 合 我 们 的 要 求 。 男 外 注意 ， 我 们 也 可 以 访 
问 与 曲目 相关 联 的 所 有 艺人 ， 而 并 非 只 限于 匹配 name 条 件 的 艺人 。 这 
正 是 预期 的 效果 ， 也 是 想 要 的 效果 ， 因 为 我 们 已 经 检索 回 实际 的 Track 
实体 。 你 可 以 调用 setResultTransformer 

(Criteria.ALIAS_TO_ENTITY_MAP) 方法 来 以 不 同 的 模式 执行 条 件 
查询 ， 让 它 返 回 一 个 层次 式 的 Map 对 象 的 列表 ， 条 件 碍 询 会 将 结果 过 
滤 到 这 个 Map 列 表 的 每 个 层次 中 。 这 部 分 主题 已 经 超出 本 书 讨论 的 范 
， 但 是 在 Hibernate 参 考 手 册 和 API 文 档 中 提供 了 一 些 示例 。 


如 宋 供 你 取 回 对 象 的 数据 表 可 能 含有 重复 的 实体 ， 可 以 调用 
Criteria 对 象 的 setResultTransformer 
(Criteria.DISTINCT_ROOT_ENTITY) 方法 ， 以 达到 与 SQL 语 名 
的 "select distinct" 相 同 的 效果 。 


示例 查询 


如 有 条 你 觉得 建立 表达 式 和 得 询 条 件 麻 烦 ， 而 你 又 有 个 对 象 能 展示 
出 要 寻找 的 目标 ， 束 能 够 以 它 为 示例 ， 让 Hibernate 为 你 建立 得 询 条 
tp 
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我 们 需要 在 QueryTest.java 里 新 增加 男 一 个 查询 方法 ， 将 例 8-19 的 
代码 添加 到 其 他 查询 所 在 类 的 顶端 。 


例 8-19: 使 用 示例 实体 来 生成 条 件 碍 询 


/** 
*Retrieve any tracks that were obtained from a particular source 
media 


*type. 


*@param media the media type of interest. 

*@param session the Hibernate session that can retrieve data. 

*@return a list of{@link Track}s meeting the media restriction. 

*/ 

public static List tracksFromMedia (SourceMedia media, Session 
session) { 

Track track=new Track () ; @ 

track.setSourceMedia (media) ; 

Example example=Example.create (track) ; @ 

Criteria criteria=session.createCriteria (Track.class) ; © 

criteria.add (example) ; 

criteria.addOrder (Order.asc ("title") ) ; 

return criteria.list () ; 


} 


四 我 们 先 创建 示例 用 的 Track 实例 ， 再 设置 SourceMedia 属 性， 以 表 
示 我 们 要 查询 的 内 容 。 


@ 接 着 将 它 包 装 到 一 个 Example 对 象 中 。 这 个 对 象 可 以 在 一 定 程度 
上 让 你 控制 在 构建 条 件 查询 时 将 会 用 什么 属性 ， 以 及 如 何 匹配 字符 
串 。 默 认 的 行为 是 ， 值 为 null 的 属性 将 被 忽略 ， 对 字符 串 值 按照 区 分 
大 小 写 的 、 逐 字 的 方式 进行 比较 。 如 果 想 在 比较 时 忽略 值 为 0 的 属性 ， 
可 以 调用 example 的 excludeZeroes () 方法 ; 或 者 ， 如 果 硕 望 对 值 为 
null 的 属性 进行 匹配 ， 可 以 调用 excludeNone () 。 而 excludeProperty 
O 方法 则 可 以 让 你 明确 地 名 略 指定 名 称 的 特定 属性 ， 不 过 这 很 像 是 
在 手工 构建 条 件 查 询 。 为 了 调整 字符 串 处 理 ， 还 可 以 使 用 ignoreCase 
O 和 enableLike () 方法 ， 从 它们 的 名 字 可 以 知道 各 自 的 用 途 。 


日 接着 ， 我 们 创建 一 个 条 件 查 询 ， 就 像 本 章 的 其 他 例子 一 样 ， 不 
同 的 是 这 里 为 条 件 查 询 增加 的 是 example， 而 不 是 使 用 Restrictions 来 创 
建 Criterion。Hibernate 会 负责 将 example 转 换 成 相应 的 criteria。 其 他 代 
码 行 与 我 们 前 面 的 查询 方法 类 似 ， 建立 排序 序列 ， 运 行 查 询 ， 返 回 匹 
配 的 实体 列表 。 


同样 地 ， 为 了 调用 新 的 查询 方法 ， 我 们 也 必须 修改 main () 方 
法 。 把 来 目 CD 的 曲目 都 找 出 来 吧 。 修 改 之 处 如 例 8-20 所 示 ° 


例 8-20: 修改 main () 方法 ， 以 调用 示例 驱动 的 查询 方法 


//Ask for a session using the JDBC information we've configured 
Session session=sessionFactory.openSession () ; 


try{ 

//Print tracks that came from CDs 

List tracks=tracksFromMedia (SourceMedia.CD, session) ; 
for (ListIterator iter=tracks.listIterator () ; 


运行 这 个 版 本 的 示例 ， 产 生 的 输出 如 例 8-21 所 示 。 
例 8-21: 以 示例 查询 来 自 CD 的 曲目 的 结果 


[java]Track: "Adagio for Strings (ATB Remix) " (ATB, Samuel 
Barber, 

William Orbit) 00: 07: 39, from Compact Disc 

[java]Track: "Adagio for Strings (Ferry Corsten Remix) " (Samuel 

Barber, William Orbit, Ferry Corsten) 00: 06: 35, from Compact 
Disc 

[java]Track: "Gravity's Angel" (Laurie Anderson) 00: 06: 06, from 

Compact Disc 

[java]Track: "Russian Trance" (PPK) 00: 03: 30, from Compact Disc 


你 可 能 觉得 这 个 例子 有 些 做 作 ， 因 为 我 们 并 没有 合适 的 Track 对 和 象 
可 以 作为 示例 ， 因 此 得 在 这 个 方法 中 创建 一 个 示例 。 咽 ， 也 许 吧 ， 但 
征 采 用 此 方法 有 个 很 有 价值 的 理由 : 与 纯 条 件 碍 询 相 比 ， 这 种 方法 在 
编译 期 间 会 做 更 多 的 检查 。 虽 然 条 件 查 询 可 以 避免 HQL 碍 询 在 运行 时 
的 语法 结构 错误 ， 但 你 还 是 可 能 会 弄 错 属 性 的 名 称 。 而 这 些 错误 是 纺 
译 需 无 法 捕获 的 ， 因 为 名 称 只 是 字符 溃 而 已 。 当 你 建立 示例 查询 时 ， 
实际 上 是 以 该 实体 的 存 取 器 方法 (01) (mutator method) 来 设置 属 


性 值 的 内 容 。 这 意味 看 ， 如 末 你 输入 错 子 ，Java 会 在 编译 期 间 束 捕获 
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你 大 概 想得到 ， 也 可 以 让 子 条 件 查询 (subcriteria) 使 用 示例 来 查 
询 相 关联 的 对 象 。 我 们 可 以 重 写 tracksWithArtistLike () ， 使 用 一 个 作 
为 示例 用 的 Artist 对 象 ， 而 非 自 己 手 工 建立 查询 条 件 。 最 后 再 调用 示例 
对 象 的 enableLike () 方法 。 例 8-22 演 示 了 完成 这 一 功能 的 简洁 方法 。 


例 8-22: 更 新 志 人 姓名 查询 ， 使 用 一 个 亏 人 对 象 作 为 示例 


public static List trackswithArtistLike (String namePattern, 
Session session) 


Criteria criteria=session.createCriteria (Track.class) ; 
Example example=Example.create (new Artist (namePattern, null, 
null) ) 
criteria.createCriteria ("artists") .add (example.enableLike 
© ) .addOrder ( 
Order.asc ("name") .ignoreCase () ) ; 
return criteria.list () ; 


这 一 过 程 的 输出 与 我 们 前 面 “手工 ”构建 的 内 部 条 件 查 询 生 成 的 输 
出 完全 一 样 。 如 有 果 你 想 运 行 这 个 例子 ， 记 得 把 main O 换 回 例 8-17 的 


样子 。 


注意 : 条 件 查 询 相 当 人 简单 ， 对 吧 ? 和 原来 Hibernate 2 中 的 相 比 ， 
现在 它们 的 功能 更 强大 ， 我 更 喜欢 它们 了 。 


各 种 各 样 的 查询 可 以 增强 用 户 界 面 的 功能 ， 数 据 驱 动 (data- 
driven) 的 Java 应 用 程序 的 典型 操作 也 可 以 表示 成 条 件 查 询 。 在 可 读 
bE > SERA MBER EGA (CAR) 等 各 方面 ， 条 件 
查询 都 有 其 优点 。 束 目前 这 些 新 的 数据 库 API 而 言 ， 我 认为 条 件 查 询 
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回 实 例 变量 值 的 存 取 器 方法 称 为 获取 方法 〈 即 get 方 法 ) ; 用 于 为 实例 
变量 赋值 的 存 取 铝 方法 称 为 设置 方法 ( 即 set 方 法 ) 。 
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我 们 已 经 看 到 ， 使 用 Criteria API 来 表达 你 想 要 实现 的 查询 ， 通 常 
都 会 有 多 种 方法 ， 到 确 使 用 哪 一 种 方法 取决 于 你 对 系统 风格 的 偏好 或 
著 虑 问题 的 方式 。Property 类 提供 了 男 一 组 奉 换 方法 ， 你 应 该 对 此 有 所 
了 解 。 我 们 在 这 里 不 会 深入 研究 这 个 类 ， 因 为 它 只 是 建 立 条 件 查询 的 
男 一 种 方法 。 不 过 ， 解 释 一 下 它 的 工作 原理 ， 也 很 重要 ， 这 样 才 不 至 
于 在 运行 许多 示例 时 感到 困惑 ， 也 不 至 于 在 浏览 Hibernate 高 密度 的 
JavaDoc 时 感觉 有 阻碍 。 (坦率 地 说 ， 经 过 一 两 个 示例 以 后 ， 你 肯定 对 
以 后 会 采用 什么 方法 而 有 足够 的 想法 了 。) 


Property 是 条 件 查 询 的 男 一 个 工厂 类， 与 Restrictions 非 常 像 ， 本 章 
已 经 用 过 了 Restrictions (还 有 Order 和 Projection， 都 差不多 ) 。 其 实 ， 
只 使 用 Property 就 完全 可 以 创建 其 他 工厂 类 提供 的 所 有 查询 约束 条 件 。 
不 像 前 面 那样 是 先 从 感 兴趣 的 约束 条 件 开始 ， 再 为 需要 使 用 的 属性 命 
名 ，Property 是 先 从 属性 开始 ， 再 挑选 一 个 合适 的 约束 条 件 。 


TER: 相当 抽象 ! 演示 些 例子 吧 ! 


和 以 前 一 样 ， 先 在 想 要 查询 的 对 象 上 创建 一 个 Criteria。 但 接 下 来 
不 是 用 以 前 的 方法 ， 例 如 : 


criteria.add (Restrictions.le ("playTime", length) ) ; 


而 征用 : 


criteria.add (Property.forName ("playTime") .le (length) ) ; 


这 两 条 语句 看 起 来 非常 像 〈 只 是 侧重 点 稍微 有 些 不 同 ) WRA 
英语 来 表达 同一 个 概念 时 也 有 多 种 方法 一 样 。Property 类 也 提供 了 很 多 
方法 ， 用 于 添加 约束 条 件 、 排 序 以 及 投影 。 不 能 使 用 new () 方法 来 
构造 一 个 Property 实 例 ， 你 需要 使 用 它 的 forName () 静态 工厂 方法 ， 
或 是 使 用 一 个 现 有 的 Property 实 例 ， 再 调用 它 的 getProperty () 方法 ， 
将 其 转换 为 它 的 某 个 组 成 属性 。 


以 下 列举 一 些 更 复杂 的 例子 ， 以 演示 这 种 方法 适用 的 场合 。 原 来 
我 们 使 用 过 以 下 语句 : 


criteria.addOrder (Order.asc ("name") .ignoreCase () ) ; 
现在 可 以 使 用 以 下 语句 : 


criteria.addOrder (Property.forName ("name") .asc () .ignoreCase 


0) 


对 于 投影 ， 原 来 用 的 方法 是 ， 例 如 : 


criteria.setProjection (Projections.max ("playTime") ) ; 


与 之 等 价 的 方法 可 以 表示 成 : 


criteria.setProjection (Property.forName ("playTime") .max () ) ; 


注意 : i Belt BRYA | 


这 样 ， 你 需要 从 众多 选择 中 挑选 一 种 实现 方法 。 有 时 ， 你 正在 着 
手 解决 的 问题 ， 或 是 代码 中 其 他 部 分 的 难点 ， 将 决定 使 用 某 种 风格 的 
实现 方式 。 或 者 ， 也 许 你 只 是 更 喜欢 一 种 方法 ， 束 一 直 坚 持 使 用 这 种 
方法 了 。 但 是 ， 至 少 你 现在 知道 了 可 能 会 遇 到 两 种 表达 方法 ， 应 该 能 
够 理解 任何 一 种 条 件 表 达 式 。 附 好 B 对 所 有 这 些 工 三 方法 进行 了 总 


结 。 


选择 太 多 了 吗 ? 没有 ? 嗯 ， 如 果 条 件 碍 询 还 不 能 很 好 的 解决 你 的 
问题 ， 或 者 你 希望 有 一 种 更 加 强大 的 方法 来 取代 本 章 介绍 的 所 有 选择 
(从 本 质 来 说 ， 如 果 你 更 喜欢 SQL 的 简洁 ) ， 你 就 可 以 使 用 HQL 提 供 
的 更 为 完整 的 功能 。 我 们 在 下 一 章 就 会 研究 HQL ° 


其 他 


在 条 件 查 询 中 可 以 悄悄 用 点 SQL， 以 便 可 以 利用 些 数据 库 特 定 的 
功能 或 DBA 技 巧 ? 使 用 子 查 询 ， 或 是 通过 离线 (detached) 查询 ， 以 
便 使 你 在 一 个 Hibernate session 之 外 创建 一 个 查询 ? 当 执行 查询 时 ， 可 


以 插入 自己 的 Java 代 码 来 过 滤 结 果 ? 所 有 这 些 主题 ， 可 能 还 有 更 多 其 
他 的 ， 已 经 超出 本 书 讨论 的 范围 。 如 果 你 准备 学 习 它 们 ，《Java 
Persistence with Hibernate) (H!) 这 本 书 的 "Advanced query 

options" 〈 高 级 查询 选项 ) 一 章 就 提供 了 一 个 好 的 概览 ，Hibernate 


JavaDoc 和 源 代 人 码 也 是 不 错 的 参考 。 


[1] 中 文书 名 叫 《Hibernate 实 战 》。 


第 9 章 ” 浅 谈 HQL 


前 面 儿 章 已 经 多 次 用 过 HQL 碍 询 了 。 这 里 值得 化 点 时 间 来 了 解 
HQL 和 SQL 的 差异 ， 看 看 能 用 HQL 做 些 什么 有 用 的 事 。 和 本 书 其 他 章 
节 一 样 ， 我 们 旨 在 提供 有 用 的 简介 和 示例 ， 而 不 和 是 完整 的 参考 于 册 。 


在 第 7 章 曾 经 提 到 ，JPA 的 查询 语言 症 HQL 的 一 个 子 集 。 所 以 ， 如 
果 学 会 了 HQL， 也 应 该 能 够 读 懂 JPA 查 询 语言 (QL) ， 如 果 ， 你 用 
JPA 编 写 查询 ， 那 么 你 就 有 足够 的 理由 去 超越 它 。 大 多 数 情 况 下 ， 只 
要 付出 很 小 的 努力 ， 束 可 以 学 会 如 何 使 用 Hibernate 了 。 


正如 第 7 章 结尾 所 述 ， 本 章 的 示例 将 使 用 XML 映射 文件 。 所 以 ， 
如 有 果 你 在 前 面 因 为 处 理 标 注 而 修改 了 什么 东西 ， 在 开始 学 习 本 章 以 
前 ， 最 好 先 下 载 示例 代码 ， 并 放 到 本 章 的 目录 中 。 


编写 HQL 查 询 


我 们 已 经 演示 过 ，HQL 碍 询 中 用 到 的 语法 成 分 会 比 SQL 的 少 点 
(比如 在 第 3 革 中 ， 我 们 使 用 的 查询 语句 通常 就 省 略 了 "select" 子 
句 ) 。 事 实 上 ， 人 惟一 真正 需要 指定 的 内 容 就 是 你 感 兴趣 的 类 。 例 9-1 显 
示 了 一 个 最 简单 的 查询 ， 对 于 取得 数据 库 中 所 有 持久 保存 的 Track 实例 
来 说 ， 这 完全 是 一 种 有 效 的 方式 。 


注意 : HQL 代 表 Hibernate Query Language。 那 SQL 呢 ? 这 得 看 你 
问 的 是 谁 了 。 


例 9-1: 最 简单 的 HQL 查 询 


from Track 


没什么 内 容 ， 对 吧 ? 这 一 HQL 束 相当 于 例 8-1， 在 那个 例子 中 我 们 
对 Track 类 建立 了 一 个 条 件 查 询 ， 但 没有 提供 任何 查询 条 件 。 


默认 情况 下 ，Hibernate 会 自动 < 导入” (import) 你 映射 的 每 个 类 的 
名 称 ， 这 意味 着 当 你 想 使 用 一 个 类 时 ， 不 必 提 供 完 整 的 包 名 称 ， 只 需 
要 简单 的 类 名 就 可 以 了 。 只 要 映射 的 类 名 称 是 惟一 的 ， 就 不 需要 在 查 
询 中 使 用 完整 限定 的 类 名 (fully qualified class name) 。 如 果 你 喜欢 ， 
当然 也 可 以 这 么 做 ， 本 书 就 是 这 样 做 的 ， 目 的 是 帮助 读者 记 住 查 询 是 
按照 Java 数 据 bean 及 其 属性 来 表示 的 ， 而 并 非 数据 表 和 字段 (在 SQL 
查询 中 使 用 这 些 ) 。 例 9-2 的 结果 和 第 一 个 查询 的 结果 完全 相同 。 


例 9-2: 显 式 指定 包 名 ,但 依然 相当 信 单 


from com.oreilly.hh.data.Track 


如 果 需 要 映 映 的 多 个 类 具有 相同 的 名 称 ， 你 可 以 用 完全 限定 的 包 
名 来 引用 每 个 类 ， 也 可 以 在 其 映射 文件 中 使 用 import 标 等 为 该 类 或 多 


个 类 指定 蔡 换 名 称 。 还 可 以 在 映射 文件 中 为 最 顶层 的 hibernate- 
mapping 标 签 属性 添加 一 个 auto-import=false 设 置 ， 以 关 掉 上 自动 导入 


(auto-import) 的 功能 。 

你 可 能 已 经 习惯 编写 查询 语句 时 不 区 分 大 小 写 ， 因 为 SQL 的 行为 
就 是 如 此 。 大 多 数 时 候 ，HQL 也 是 如 此 。 但 是 类 和 属性 的 名 称 显然 是 
例外 。 和 Java 的 其 他 组 成 部 分 一 样 ， 它 们 是 区 分 大 小 写 的 ， 所 以 你 得 
把 大 小 写 弄 对 。 

让 我 们 看 一 个 极端 的 示例 ， 它 把 HQL 的 多 态 (polymorphic) 查询 
能 力 推 向 它 的 逻辑 上 的 极限 ， 以 此 来 了 解 HQL 和 SQL 究竟 在 哪 不 同 。 
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突出 SQL 和 HQL 基 本 差别 的 最 有 效 方 式 就 是 ， 考 虚 当 以 "from 
java.lang.Object" 来 进行 查询 时 会 发 生 什么 事 。 乍 一 看 ， 可 能 看 不 出 什 
么 意义 ! 事实 上 ，Hibernate 能 够 支持 返回 多 态 结果 的 查询 。 如 果 映 射 
到 的 类 之 间 是 彼此 继承 的 ， 或 者 有 共同 的 基 类 或 接口 ， 那 么 无 论 是 否 
将 这 些 类 映射 到 相同 的 数据 表 或 不 同 的 数据 表 ， 都 可 以 查询 到 它们 的 
超 类 (superclass) 。 由 于 每 个 Java 对 象 都 继承 自 Object， 所 以 这 样 的 
查询 就 等 于 要 求 Hibernate 返 回 数据 库 里 的 每 个 实体 。 我 们 可 以 对 查询 
测试 做 个 快速 的 修改 ， 以 测试 一 下 这 一 查询 。 把 QueryTest.java 复 制 成 


QueryTest3.java， 按 例 9-3 所 示 的 内 容 对 它 进行 修改 〈 大 多 数 修改 都 是 
将 这 里 不 需要 的 示例 查询 删除 挥 ， 所 以 例 9-3 中 看 不 到 那些 被 删除 的 部 


分 ) 。 


如 有 条 你 正在 使 用 Eclipse， 那 么 可 以 直接 跳 到 第 11 章 ， 阅 读 有 关 
Hibernate Tools 的 章节 ， 再 回来 继续 学 习 本 章 的 内 容 。 那 一 章 介 绍 的 
HQL Editor 是 一 个 非常 方便 的 工具 ， 可 以 帮助 你 处 理 我 们 需要 得 看 的 
各 种 查询 。 用 它 来 做 实验 太 有 效 了 ， 可 以 接合 你 目 己 的 修改 ， 帮 助 你 
更 深入 地 学 习 HQL ° 


例 9-3: 看 吧 ， 再 也 不 用 SQL 了 


package com.oreilly.hh; 

import org.hibernate.’*; 

import org.hibernate.cfg.Configuration; 
import org.hibernate.criterion.’*; 
import com.oreilly.hh.data.*; 

import java.util.*; 


JEK 

*Retrieve all persistent objects 
*/ 

public class QueryTest3{ 

fies 


*Look up and print all entities when invoked from the command 
line. 

S7: 

public static void main (String args[]) throws Exception{ 

//Create a configuration based on the properties file we've put 

//in the standard place. 

Configuration config=new Configuration () ; 

config.configure () ; 

//Get the session factory we can use for persistence 

SessionFactory sessionFactory=config.buildSessionFactory () ; 

//Ask for a session using the JDBC information we've configured 

Session session=sessionFactory.openSession () ; 


try{ 
//Print every mapped object in the database 
List all=session.createQuery ("from java.lang.Object") .list () ; 


for (Object obj: all) { 
System.out.println (obj) ; @ 


} 

}finally{ 

//No matter what, close the session 
session.close () ; 


//Clean up after ourselves 
sessionFactory.close 


} 


行 简单 的 代码 就 调用 了 奇妙 而 功能 强大 的 HQL 查 询 。 


@ 接 下 来 所 有 需要 做 的 束 是 循环 直 历 和 打印 输出 我 们 找到 的 结 
果 。 除 了 调用 取 回 的 对 象 的 toString O 方法 以 外 ， 我 们 什么 也 不 能 
做 ， 因 为 我 们 不 知道 它们 是 什么 类 。 作 为 共 至 接口 ，Object 没 有 提供 
非常 深入 的 方法 。 


在 运行 这 个 示例 之 前 ， 还 得 再 多 做 一 件 事 。 在 build.xml 中 添加 另 
一 个 构建 目标 ， 如 例 9-4 所 示 。 


和 以 前 一 样 ， 假 设 你 已 经 按照 前 面 草 世 的 说 明 搭 建 好 了 环境 。 也 
可 以 直接 下 载 使 用 为 这 一 革 提 供 的 示例 源 代码 。 如 有 果 你 从 第 7 章 过 来 ， 
将 映射 文档 换 成 了 标注 ， 则 要 么 你 需要 回 到 第 6 章 的 源 代 码 ， 要 么 重新 
下 载 本 章 的 产 代 码 ， 因 为 本 章 的 这 些 示 例 需 要 依靠 映 出 文件 的 功能 


例 9-4: 调用 这 个 特殊 查询 


<target name="qtest3"description="Retrieve all mapped objects" 
depends="compile" > 

<java classname="com.oreilly.hh.QueryTest3"fork="true" > 
<classpath refid="project.class.path"/> 

</java> 

</target> 


为 了 确保 创建 好 所 有 的 样 例 数 据 ， 先 要 运 云 行 ant schema ctest atest 
命令 。 接 着 ， 再 执行 ant qtest3 命 令 以 测试 新 的 查询 ， 得 到 的 结果 如 例 
9-5 所 示 。 


例 9-5: Hibernate 能 找到 一 切 事物 


%ant qtest3 

Buildfile: build.xml 

prepare: 

usertypes: 

codegen: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]i.task: hbm2java (Generates a set of.java files) 

compile: 

[javac]Compiling 4 source files 
to/Users/jim/Documents/Work/OReilly 

/svn_hibernate/current/examples/ch09/classes 

qtest3: 

[java]com.oreilly.hh.data.Artist@8a137c[name='PPK'actualArtist=' 
null'] 

[java]com.oreilly.hh.data.Artist@79e4c[name='The 
Buggles'actualArtist='n 

ull'] 

[java]com.oreilly.hh.data.Artist@29ae5e[name='Laurie 
Anderson'actualArti 

st='null'] 

[java]com.oreilly.hh.data.Artist@76a9b6[name='William 
Orbit'actualArtist 

='null'] 

[java]com.oreilly.hh.data.Artist@801919[name='Ferry 
Corsten'actualArtist 

='null'] 


[java]com.oreilly.hh.data.Artist@efe4ac[name='Samuel 
Barber'actualArtist 

='null'] 

[java]com.oreilly.hh.data.Artist@8e13ab[name='ATB'actualArtist=' 
null' J 

[java]com.oreilly.hh.data.Artist@ad44f6[name='Pulp 
Victim'actualArtist 

='null'] 

[java]com.oreilly.hh.data.Artist@8aaed5[name='Martin 
L.Gore'actualArtist 

='"null'] 

[java]com.oreilly.hh.data.Album@ai644b[title='Counterfeit 
e.p.'tracks='[ 

com.oreilly.hh.data.AlbumTrack@132f26[track='com.oreilly.hh.data 
. Track@d8f246[ 

title='Compulsion'volume='Volume[left=100, 
right=100] 'sourceMedia='CD']'], c 

om.oreilly.hh.data.AlbumTrack@5ae101[track='com.oreilly.hh.data. 
Track@9eab7[ti 

tle='In a Manner of Speaking'volume='Volume[left=100, 
right=100] 'sourceMedia=' 

cD']'], 
com.oreilly.hh.data.AlbumTrack@6a16ae[track='com.oreilly.hh.data.Tr 
ac 

k@10cf62[title='Smile in the Crowd'volume='Volume[left=100, 
right=100] 'source 

Media='CD']'], 
com.oreilly.hh.data.AlbumTrack@f7309a[track='com.oreilly.hh.da 

ta. Track@9f332b[title='Gone'volume='Volume[left=100, 
right=100] 'sourceMedia=' 

CD']'], 
com.oreilly.hh.data.AlbumTrack@97cf78[track='com.oreilly.hh.data.Tr 
ac 

k@d86cae[title='Never Turn Your Back on Mother 
Earth'volume='Volume[left=100, 

right=100]'sourceMedia='CD']'], 
com.oreilly.hh.data.AlbumTrack@b5d53a[track= 

‘com.oreilly.hh.data.Track@c74b55[title='Motherless 
Child'volume='Volume[left= 

100, right=100] 'sourceMedia='CD']']]'] 

[java]com.oreilly.hh.data.Track@e74d83[title='Russian 
Trance 'volume='Vol 

ume[left=100, right=100]'sourceMedia='CD' | 

[java]com.oreilly.hh.data.Track@5d8362[title='Video Killed the 
Radio Star 

"volume='Volume[left=100, right=100] 'sourceMedia='VHS' ] 

[java]com.oreilly.hh.data.Track@5c9ab5[title='Gravity's 
Angel'volume='Vo 


lume[left=100, right=100] 'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@b0e76a[title='Adagio for Strings 
(Ferry C 

orsten Remix) 'volume='Volume[left=100, 
right=100] 'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@28ea3f[title='Adagio for Strings 
(ATB Rem 

ix) 'volume='Volume[left=100, right=100]'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@2af08b[title='The 
World'99'volume='Volu 

me[left=100, right=100]'sourceMedia='STREAM' ] 

[java]com.oreilly.hh.data.Track@164feb[title='Test Tone 
1'volume='Volume 

[left=50, right=75]'sourceMedia='null' ] 

[java]com.oreilly.hh.data.Track@d8f246[title='Compulsion 'volume= 
'Volume[ 

left=100, right=100]'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@9eab7[title='In a Manner of 
Speaking'vol 

ume='Volume[left=100, right=100] 'sourceMedia='CD' | 

[java]com.oreilly.hh.data.Track@10cf62[title='Smile in the 
Crowd 'volume= 

'Volume[left=100, right=100] 'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@9f332b[title='Gone 'volume='Volum 
e[left=1 

00, right=100]'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@d86cae[title='Never Turn Your 
Back on Mot 

her Earth'volume='Volume[left=100, right=100]'sourceMedia='CD' ] 

[java]com.oreilly.hh.data.Track@c74b55[title='Motherless 
Child'volume='V 

olume[left=100, right=100] 'sourceMedia='CD' ] 

BUILD SUCCESSFUL 

Total time: 9 seconds 
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WA (FE, AEN, A) Hibernate ag LYK 
SQL 查询 才能 获得 我 们 想 要 的 所 有 结果 。Hibernate 在 幕后 做 了 很 多 工 
作 ， 才 能 把 每 个 它 知道 的 持久 化 实体 的 列表 交 给 我 们 。 虽 然 很 难 想象 


实际 需要 这 么 做 的 情况 ， 但 这 确实 突出 了 HQL 和 Hibernate 有 趣 的 能 
所 在 。 


有 了 时候 某 些 查 询 确 实 有 些 难以 理解 ， 但 却 非 常 有 用 。 所 以 记 住 这 
一 点 很 有 价值 ， 跨 表 的 多 态 查 询 (polymorphic query) 不 仅 可 行 ， 而 
且 容 易 使 用 。 


当 你 执行 需要 多 条 SQL 查询 才能 完成 的 HQL 查 询 时 ， 会 有 些 限 制 
需要 注意 。 不 能 使 用 order by 子 句 对 整个 结果 集 进 行 排 序 ， 也 不 能 使 用 
Query 接 口 scroll () 方法 遍历 整个 结果 集 。 


其 他 


关联 (association) 和 连接 (join) WE? 这些 也 容易 处 理 。 只 要 使 
用 点 号 作为 分 隔 符 (delimiter) ， 顺 着 属性 链 走 ， 就 能 访问 关联 对 
象 。 为 了 帮助 你 引用 查询 表达 式 中 的 特定 实体 ，HQL 可 以 让 你 指定 别 
名 (就 像 SQL 一 样 ) 。 如 果 你 想 引 用 同一 个 类 的 两 个 不 同 的 实体 ， 别 
名 就 特别 重要 ， 例 如 : 


from com.oreilly.hh.Track as track1 


相当 于 : 


from com.oreilly.hh.Track track1 


采用 哪 一 种 方法 取决 于 你 的 习惯 ， 或 者 取决 于 你 为 项 目 准 备 的 编 
码 风格 指南 。 


我 们 对 其 他 HQL 元 素 进行 了 足够 的 介绍 ， 束 是 想 让 它们 吸引 起 你 
的 兴趣 。 稍 后 我 们 会 看 看 一 些 连接 的 示例 。 


选择 属性 和 其 他 部 件 


到 目前 为 止 ， 我 们 用 的 查询 返回 的 都 是 整个 持久 化 对 象 。 这 是 像 
Hibernate 这 类 对 象 /关系 映射 服务 组 件 最 常见 的 用 法 ， 所 以 应 该 没什么 
可 奇怪 的 。 在 得 到 这 些 持久 化 对 象 以 后 ， 就 可 以 在 你 熟悉 的 Java 代 码 
世界 中 用 它们 做 任何 你 想 做 的 事 。 但 是 在 有 些 情况 下 ， 你 可 能 只 想 取 
出 组 成 对 象 的 所 有 属性 的 一 个 子 集 ， 例 如 生成 报表 。HQL 也 能 满足 这 
样 的 需要 ， 和 普通 SQL 的 使 用 方式 一 样 ， 也 就 是 在 select 子 句 中 使 用 
SQL 投影 (SQL-projection) 。 


DEAE il 


假设 我 们 想 在 QueryTestjava 的 基础 上 进行 修改 ， 使 其 只 显示 符合 
查询 条 件 的 曲目 的 标题 ， 而 且 想 从 数据 库 中 一 开始 提取 的 信息 就 只 包 
含 曲目 的 标题 。 首 先 ， 要 修改 例 3-11 的 查询 ， 让 它 只 检索 回 title 属 性 。 
编辑 Track.hbm.xml， 使 其 查询 内 容 看 起 来 如 例 9-6 所 示 。 


例 9-6: 只 获取 短 曲 目的 标题 


<query name="com.oreilly.hh.tracksNoLongerThan" > 

<! [CDATA[ 

select track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 

]] > 


</query> 


要 确保 让 QueryTest.java 中 的 tracksNoLongerThan () 方法 使 用 这 
个 查询 。 〈 如 果 你 在 第 8 草 将 它 修 改 成 使 用 条 件 查询 ， 就 要 再 改 回 例 3- 
12 的 样子 。 为 了 节省 查找 的 麻烦 ， 例 9-7 又 重新 生成 了 一 次 。) 


例 9-7: HQL 驱 动 的 查询 方法 ， 使 用 例 9-6 中 映 映 的 查询 


public static List tracksNoLongerThan (Time length, Session 
session) { 

Query query=session.getNamedQuery ( 

"com.oreilly.hh.tracksNoLongerThan") ; 

query.setTime ("length", length) ; 

return query.list () ; 


} 


最 后 ， 还 需要 更 新 main O 方法 (如 例 9-8 所 示 ) ， 以 反映 一 个 事 
SE: 这 个 查询 方法 现在 返回 的 是 title 属 性 ， 而 不 是 整个 Track 记录 。 
个 属性 的 类 型 是 String， 所 以 ， 现 在 这 个 查询 方法 返回 的 是 一 个 由 
String 组 成 的 List 对 象 。 


例 9-8: 修改 QueryTest 的 main () 方法 ， 以 处 理 标题 查询 


//Print the titles of tracks that will fit in five minutes 
List titles=tracksNoLongerThan (Time.valueOf ("00: 05: 00") , 
session) ; 

for (ListIterator iter=titles.listIterator () : 

iter.hasNext () ; ) { 

String title= (String) iter.next () ; 

System.out.println ("Track: "+title) ; 

} 


这 些 修改 都 相当 简单 ， 而 Java 程 序 中 查询 返回 的 类 型 和 List 元 素 之 
间 的 关系 也 一 目 了 然 。 使 用 ant qtest 命 令 运行 这 个 例子 ， 就 会 得 到 类 似 
例 9-9 的 输出 结果 ， 至 于 实际 显示 的 数据 ， 则 取决 于 你 已 经 设 定 的 数 
据 。 (如 果 还 没有 任何 数据 ， 或 者 你 想 要 的 结果 ， 输 出 前 可 以 执行 ant 
schema ctest atest qtest， 这 样 会 重建 测试 数据 。) 


例 9-9: 只 列 出 时 间 长 度 不 超过 5 分 钟 的 曲目 的 标题 


qtest: 

[java]Track: Russian Trance 

[java]Track: Video Killed the Radio Star 
[java]Track: Test Tone 1 

[java]Track: In a Manner of Speaking 

[java]Track: Gone 

[java]Track: Never Turn Your Back on Mother Earth 
[java]Track: Motherless Child 


其 他 


要 返回 多 个 属性 ? 当然 可 以 。 如 果 你 使 用 连接 (join) 或 者 你 的 
查询 对 象 中 有 多 个 组 件 或 关联 (毕竟 这 是 面向 对 象 关联 非常 方便 的 方 
A) ， 在 这 些 情况 下 ， 属 性 都 可 以 来 自 多 个 对 象 。 如 同 SQL 那样 ， 你 
所 做 的 就 是 列 出 需要 的 属性 ， 并 以 逗号 分 隔 。 举 一 个 简单 的 例子 ， 假 
设 我 们 要 得 到 曲目 的 标题 和 ID。 调 整 Track.hbm.xml， 使 查询 内 容 如 例 
9-10 所 示 。 


例 9-10: 从 一 个 对 象 中 选择 多 个 属性 


<query name="com.oreilly.hh.tracksNoLongerThan" > 

<! [CDATA[ 

select track.id, track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 

]] > 

</query> 


根本 不 需要 修改 查询 方法 ， 还 是 以 相同 的 名 称 调 用 这 个 查询 ， 并 
传递 相同 的 命名 参数 ， 再 返回 保存 有 结 采 的 列表 。 但 是 这 个 列表 中 现 
在 包含 什么 ? 我 们 需要 更 新 main () 中 的 循环 ， 才 能 同时 显示 曲目 的 
ID 和 标题 。 


像 这 种 情况 ， 查 询 结果 的 每 一 “ 行 ”(row) 都 要 返回 多 个 值 ， 所 以 
Hibernate 返 回 的 List 对 象 中 的 每 个 条 目 都 会 包含 一 个 对 象 数 组 。 每 个 数 
组 都 包含 我 们 所 选择 的 属性 ， 排 列 顺序 按照 各 属性 在 查询 语句 中 的 位 
置 而 定 。 这 样 ， 我 们 会 得 到 一 个 包含 两 个 元 素 的 数组 的 列表 ， 每 个 数 
组 内 包含 一 个 Integer 对 象 ， 再 接着 包含 一 个 String 对 象 。 


例 9-11 演 示 了 如 何 更 新 QueryTest.java 中 的 main O ， 以 处 理 这 些 
数组 。 


例 9-11: 处 理 碍 询 结 采 中 多 个 单独 的 属性 


//Print IDs and titles of tracks that will fit in five minutes 
List titles=tracksNoLongerThan (Time.valueOf ("00: 05: 00") , 
session) ; 

for (ListIterator iter=titles.listIterator () : 

iter.hasNext (); ) { 

Object[]row= (Object[]) iter.next () ; 

Integer id= (Integer) row[0]; 


String title= (String) row[1]; 
System.out.printin ("Track: "+aTitle+"[ID="+id+']') ; 
} 


经 过 这 些 修改 以 后 ， 执 行 ant qtest， 可 以 得 到 类 似 例 9-12 的 输出 。 
fil9-12: 列 出 曲目 的 标题 和 ID 


qtest: 

[java]Track: Russian Trance[ID=1] 

[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 

[java]Track: In a Manner of Speaking[ID=9] 

[java]Track: Gone[ID=11] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[java]Track: Motherless Child[ID=13] 


我 希望 你 在 看 这 个 示例 时 会 想 : “这 种 使 用 Track 对 象 属性 的 方法 
BE! ”。 如 果 你 没 这 么 想 ， 比 较 一 下 例 9-11 和 例 3-7 中 的 对 应 代码 。 
后 者 更 为 精简 而 目 然 ， 甚 至 能 够 显示 出 更 多 的 曲目 信息 。 如 有 果 要 提取 
出 映射 对 象 的 信息 ， 最 好 是 充分 利用 映 喘 的 能 力 以 提取 出 对 象 的 真正 
的 实例 ， 这 样 你 束 能 用 表达 能 力 更 强 而 且 类 型 安全 的 Java 代 码 来 处 理 
EWERT ° 


注意 ;这 古 那 种 残酷 的 玩笑 吗 ? 


既然 如 此 ， 为 什么 还 要 这 样 做 ? 咽 ， 在 某 些 情况 下 ， 用 HQL 检 索 
回 多 个 值 有 其 用 途 所 在 。 例 如 ， 对 某 些 映 冉 类 ， 你 只 想 从 每 个 类 中 取 
出 一 个 属性 ; 或者， 你 可 能 想 通 过 在 select 于 人 句 中 列 出 一 些 类 名 来 返回 


一 组 相关 的 类 。 对 于 这 些 情况 而 言 ， 知 道 这 种 技巧 有 其 价值 所 在 。 如 
果 你 的 映射 对 象 有 很 多 大 型 的 〈 或 非 延 迟 加 载 关 联 的 ) 属性， 但 你 只 
对 其 中 的 一 两 个 属性 感 兴趣 ， 这 一 技巧 也 许 能 在 性 能 上 让 你 受益 菲 

mm 


此 外 ， 当 你 从 不 同 映 射 对 象 中 选择 一 大 组 属性 以 建立 报表 时 ， 还 
有 另 一 种 技巧 可 以 用 来 方便 地 构建 良好 的 对 象 结 构 。HQL 可 以 让 你 在 
select 子 句 内 构建 并 返回 任意 对 象 。 所 以 ， 你 可 以 创建 一 个 专门 的 报表 
类 ， 它 的 属性 就 是 你 的 报表 需要 的 值 ， 然 后 在 查询 中 返回 这 个 报表 类 
的 实例 ， 而 不 是 返回 星 涩 难 懂 的 Object 数 组 。 如 果 我 们 定义 一 个 具有 id 
和 title 属 性 的 TrackSummary 类 ， 以 及 与 之 相配 的 构造 函数 ， 如 此 一 来 
就 能 够 使 用 以 下 的 查询 : 


select new TrackSummary (track.id, track.title) 


而 不 是 使 用 : 


select track.id, track.title 


这 样 ， 我 们 束 不 用 在 处 理 查 询 结果 的 代码 中 对 数组 进行 处 理 。 
(再 一 次 ， 束 这 个 例子 来 说 ， 简 单 地 返回 整个 Track 实 例 是 比较 有 意义 
的 ， 但 是 当 你 要 使 用 来 自 多 个 对 象 的 属性 或 者 像 聚 合 函 数 (aggregate 
function) 这 类 合成 结果 时 (后 面 会 有 演示 ) ， 这 样 做 就 有 用 处 了 。) 


排序 


可 以 使 用 SQL 风格 的 "order by" 子 句 控制 结 采 输 出 的 顺序 ， 这 应 该 
不 会 令 你 感到 惊讶 。 前 面 儿 章 我 们 曾经 简单 提 到 过 这 一 点 ， 其 工作 原 
理 正如 你 所 料想 的 那样 。 可 以 使 用 返回 对 象 的 任何 属性 来 建立 排序 ， 
也 可 以 使 用 多 个 属性 来 建立 子 排序 (subsort) ， 以 便 在 第 一 个 属性 值 
相同 时 能 够 继续 以 其 他 属性 值 对 其 结果 进行 排序 。 


应 该 怎么 做 


排序 非常 简单 : 列 出 想 要 用 来 对 查询 结 采 进行 排序 的 值 。 和 往 各 
一 样 ，SQL 使 用 数据 库 表 的 字段 ， 而 HQL 使 用 对 象 的 属性 。 对 于 例 9- 
13 来 说 ， 我 们 更 新 了 例 9-10 的 查询 ， 让 它 以 倒序 的 字母 顺序 显示 结 
果 。 


JER: 和 SQL 一 样 ， 递 增 的 顺序 使 用 "asc"， 而 递减 的 顺序 使 
用 "desc"。 


例 9-13: 在 Track.hbm.xml 中 加 点 新 东西 ， 按 标题 倒序 对 结果 进行 
排序 


<query name="com.oreilly.hh.tracksNoLongerThan" > 
<! [CDATA[ 


select track.id, track.title from com.oreilly.hh.Track as track 
where track.playTime<=: length 

order by track.title desc 

]] > 

</query> 


运行 这 个 示例 的 输出 结果 如 你 所 料 (如 例 9-14 所 示 ) 。 


例 9-14: 以 倒序 的 字母 顺序 列 出 的 标题 和 ID 


%ant qtest 

Buildfile: build.xml 

prepare: 

[copy]Copying 1 file 
to/Users/jim/Documents/Work/OReilly/svn_hibernate 

/current/examples/ch09/classes 

usertypes: 

qtest: 

[java]Track: Video Killed the Radio Star[ID=2] 

[java]Track: Test Tone 1[ID=7] 

[java]Track: Russian Trance[ID=1] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 

[java]Track: Motherless Child[ID=13] 

[java]Track: In a Manner of Speaking[ID=9] 

[java]Track: Gone[ID=11] 

BUILD SUCCESSFUL 

Total time: 9 seconds 


(5 FSR 1B 


我 们 时 常 需要 从 数据 库 中 提取 摘要 信息 ， 尤 其 是 在 做 报表 的 时 
R: 有 多 少 ? 平均 值 ? 最 长 的 ? HQL 也 支持 这 一 功能 ， 办 法 束 古 提供 
与 SQL 类 似 的 聚合 函数 (aggregate function) 。 当 然 ， 在 HQL 中 ， 这 些 
函数 是 针对 持久 化 类 的 属性 而 进行 运算 的 。 


应 该 怎么 做 


我 们 以 目前 现 有 的 一 些 查询 测试 框架 为 基础 试 一 试 吧 。 首 先 ， 在 
Track.hbm.xml 中 现 有 的 查询 内 容 之 后 再 新 添加 例 9-15 所 示 的 查询 内 


AH 


Xo 
例 9-15: 一 个 用 于 收集 曲目 的 聚合 信息 的 查询 


<query name="com.oreilly.hh.trackSummary" > 

<! [CDATA[ 

select count (*) , min (track.playTime) , max (track.playTime) 
from Track as track 

]] > 

</query> 


我 原来 试图 取出 平均 播放 时 间 ， 但 很 不 幸 ，HSQLDB 不 知道 应 该 
如 何 为 非 数 值 的 字段 计算 平均 值 ， 因 为 这 个 属性 是 保存 在 数据 库 类 型 
为 date (AHH) 的 字段 中 。 


接 下 来 ， 我 们 必须 写 一 个 方法 去 执行 这 个 查询 ， 并 显示 结果 。 把 
例 9-16 所 示 的 代码 加 进 QueryTestjava， 就 放 在 tracksNoLongerThan () 
方法 的 后 面 。 


例 9-16: 执行 trackSummary 查 询 的 方法 


JER 

*Print summary information about all tracks. 

* 

*@param session the Hibernate session that can retrieve data. 

ERS 

public static void printTrackSummary (Session session) { 

Query query=session.getNamedQuery 
("com.oreilly.hh.trackSummary") ; 

Object[]results= (Object[]) query.uniqueResult () ; 

System.out.println ("Summary information: ") ; 

System.out.printin ("Total tracks: "+results[@]) ; 

System.out.printlin ("Shortest track: "+tresults[1]) ; 

System.out.printlin ("Longest track: "+results[2]) ; 


Be A eB a P ARS Na, AERA Ae ENARA 
会 有 一 行 数据 。 在 这 种 情况 下 ， 束 可 以 使 用 Query 接 口 提供 的 男 一 个 更 
加 方便 的 uniqueResult () 方法 ， 这 样 能 免 去 取 回 一 个 列表 ， 并 把 列表 
的 第 一 个 元 素 取 出 来 的 麻烦 。 如 本 节 前 面 的 9.2 节 所 述 ， 因 为 我 们 要 求 
的 是 几 个 不 同 的 值 ， 因 此 结果 将 会 是 一 个 Object 数 组 ， 其 元 素 束 古 我 
们 请 求 的 那些 值 ， 它 们 的 顺序 与 查询 结果 中 的 排列 顺序 相同 。 (这 段 
RBA EREHE, EH TEREE EZT AHS H o AMER 
们 演示 的 为 什么 需要 为 得 询 创 建 <“ 报 表 对 象 "的 原因 了 ， 使 用 报表 对 象 
将 会 让 处 理 变 得 比 现在 要 方便 得 多 。 在 普通 的 SQL 语句 中 ， 你 可 以 为 


字段 起 个 名 称 ， 通 过 名 称 从 ResultSet 〈 结 果 集 ) 中 取 回 字段 值 ; 在 
HQL 中 ， 你 可 以 声明 类 ， 并 在 查询 中 创建 这 个 类 的 实例 。) 


我 们 还 需要 在 main () 中 新 添加 一 行 代码 来 调用 这 个 方法 。 可 以 
将 这 行 代码 放 在 打印 输出 选择 的 曲目 详细 信息 的 循环 之 后 ， 如 例 9-17 
所 示 。 


例 9-17: 在 QueryTest.java 中 的 main () 中 新 增加 一 行 ， 以 显示 新 
的 摘要 信息 


System.out.printin ("Track: "+aTitle+"[ID="+anID+']') ; 
}printTrackSummary (session) ; 

}finally{ 

//No matter what, close the session 


增加 好 代码 以 后 ， 执 行 ant qtest， 束 可 以 得 到 新 的 输出 ， 如 例 9-18 
所 示 。 


例 9-18: 摘要 输出 


qtest: 

[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 

[java]Track: Russian Trance[ID=1] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[java]Track: Motherless Child[ID=13] 

[java]Track: In a Manner of Speaking[ID=9] 

[java]Track: Gone[ID=11 ] 

[java]Summary information: 


[java]Total tracks: 13 
[java]Shortest track: 00: 00: 10 
[java]Longest track: 00: 07: 39 
BUILD SUCCESSFUL 

Total time: 9 seconds 


相当 简单 吧 。 我 们 再 试 试 比较 难处 理 的 一 从 连接 表 中 获取 信息 。 
曲目 有 一 个 关联 到 艺人 的 集合 。 假 设 我 们 想 取出 和 特定 艺人 相关 联 的 
曲目 的 摘要 信息 ， 而 不 是 所 有 曲目 的 摘要 信息 。 例 9-19 演 示 了 查询 语 
句 中 新 增加 的 部 分 。 


例 9-19: 获取 特定 艺人 相关 的 曲目 摘要 信息 


<query name="com.oreilly.hh.trackSummary" > 


<! [CDATA[ 
select count (*) , min (track.playTime) , max (track.playTime) 


from Track as track 
where: artist in elements (track.artists) 


et 
为 了 过 滤 想 看 到 的 曲目 ， 我 们 新 增 了 一 个 where 子 句 ， 以 及 一 个 命 
名 参数 artist。Hibernate 的 in 运 算 符 还 有 男 外 一 个 用 途 ， 可 以 像 在 普通 
的 SQL 语 句 中 那样 来 使 用 in 运 算 符 以 给 定 某 个 属性 可 能 取 值 的 列表 ， 
也 可 以 按 这 里 采用 的 方式 来 使 用 in。 这 个 语句 是 告诉 Hibernate， 我 们 
感 兴趣 的 曲目 是 其 artists 集 合 中 含有 特定 艺人 的 那些 曲目 。 为 了 调用 这 


一 查询 ， 需 要 对 print-TrackSummary () 做 点 修改 ， 如 例 9-20 所 示 。 


例 9-20: 改进 printTrackSummary () ， 以 处 理 特定 艺人 的 曲目 


fur 

*Print summary information about tracks associated with an 
artist. 

* 

*@param artist the artist in whose tracks we're interested. 

*@param session the Hibernate session that can retrieve data. 

xx / 

public static void printTrackSummary (Artist artist, Session 
session) { 

Query query=session.getNamedQuery 
("com.oreilly.hh.trackSummary") ; 

query.setParameter ("artist", artist) ; 

Object[]results= (Object[]) query.uniqueResult () ; 
System.out.println ("Summary of tracks by"t+artist.getName () 
eae ae 
System.out.printin ("Total tracks: "+results[0]) ; 
System.out.printin ("Shortest track: "+results[1]) ; 
System.out.printin ("Longest track: "+results[2]) ; 


} 


没 多 加 什么 ， 对 吧 ? 最 后 ， 调 用 该 方法 的 那 行 代码 需要 用 一 个 参 
数 来 指定 一 个 艺人 对 象 。 我 们 可 以 再 次 使 用 CreateTest.java 中 方便 的 
getArtist () 方法 。 修 改 QueryTestjava 的 main () 方法 中 对 该 方法 的 
调用 代码 ， 使 其 如 例 9-21 所 示 。 


例 9-21: 调用 已 改进 的 print, TrackSummary () 


System.out.println ("Track: "+title+"[ID="+id+']') ; 


printTrackSummary (CreateTest.getArtist ("Samuel Barber", 
false, session) , session) ; 

}finally{ 

//No matter what, close the session 


现在 ， 当 你 执行 ant qtest 时 ， 就 会 看 到 类 似 例 9-22 的 信息 。 


例 9-22: 运行 摘要 查询 ， 以 取得 艺人 Samuel Barber 的 所 有 曲目 


qtest: 

[java]Track: Video Killed the Radio Star[ID=2] 
[java]Track: Test Tone 1[ID=7] 

[java]Track: Russian Trance[ID=1] 

[java]Track: Never Turn Your Back on Mother Earth[ID=12] 
[java]Track: Motherless Child[ID=13] 
[java]Track: In a Manner of Speaking[ID=9] 
[java]Track: Gone[ID=11] 

[java]Summary of tracks by Samuel Barber: 
[java]Total tracks: 2 

[java]Shortest track: 00: 06: 35 

[java]Longest track: 00: 07: 39 


AEE TAP A 


注意 ， 试 着 以 普通 的 SQL 做 类 似 的 事 ! 


这 根本 不 费 吹 灰 之 力 ， 因 此 值得 花 点 时 间 来 欣赏 一 下 Hibernate 为 
我 们 做 了 多 少 事 。 我 们 调用 的 getArtist () 方法 会 返回 与 "Samuel 
Barber" 对 应 的 Artist 实 例 ， 再 将 整个 实例 对 象 作为 命名 参数 传递 给 HQL 
查询 ， 而 Hibernate 也 知道 应 该 如 何 使 用 Artist 对 象 的 id 属性 和 
TRACK_ARTISTS 表 ， 把 连接 查询 放 在 一 起 ， 以 实现 我 们 在 例 9-10 中 
简单 描述 的 那 种 复杂 情况 。 


得 到 的 结果 反映 出 示例 数据 中 那 两 个 世人 相互 混合 的 "Adagio for 
Strings" 曲 目 。 因 为 它们 都 超过 了 5 分 钟 ， 所 以 没有 出 现在 曲目 列表 
FH 6 


编写 原生 SQL 碍 询 


HQL 的 功能 强大 、 使 用 方便 ， 而 且 能 和 Java 代 码 中 的 对 象 目 然 地 
结合 起 来 ， 既 然 如 此 ， 有 什么 理由 不 去 用 HQL 呢 ? I, 项目 所 用 的 数 
据 库 可 能 有 某 些 特殊 功能 是 它 原 生 (native) 的 SQL 方言 才 文 持 的 ， 这 
时 惑 不 能 用 HQL 了。 如 有 果 你 愿意 接受 使 用 原生 SQL 会 让 以 后 数据 库 的 
更 换 变 得 更 加 困难 的 事实 ，Hibernate 还 是 可 以 让 你 使 用 这 种 原生 SQL 
方言 来 编写 查询 ， 同 时 仍然 帮助 你 以 对 象 属性 的 方式 来 编写 表达 式 ， 
并 把 查询 结 采 转换 成 对 象 《当然 ， 如 果 你 不 想 依 靠 Hibernate 的 帮助 ， 
也 可 以 使 用 原始 的 JDBC 连 接 来 执行 普通 的 SQL 查询 ) 。 


另 一 种 可 能 不 完全 符合 你 的 情况 是 ， 你 正 处 于 将 当前 现 有 的 基于 
JDBC 的 项 目 移 植 到 基于 Hibernate 的 过 程 中 ， 而 你 只 是 想 先 前 进 几 小 
步 ， 并 不 想 立 刻 彻底 重新 改写 每 个 查询 。 


应 该 怎么 做 


如 果 准 备 将 查询 语句 的 文本 舱 入 到 Java 源 代码 中 ， 可 以 用 Session 
类 的 createSQLQuery () 方法 ， 而 不 是 用 例 3-7 的 createQuery () X 
法 。 当 然 ， 你 应 该 知道 有 比 这 种 编码 方式 更 好 的 办 法 ， 所 以 我 就 不 举 
例 说 明 这 种 方法 了 。 比 较 好 的 做 法 是 把 查询 语句 放 在 映射 文档 中 ， 如 


例 3-11 所 示 。 区 别 在 于 ， 现 在 应 该 使 用 < sql-query > 标签 ， 而 不 是 我 
们 一 直 在 用 的 query 标 签 。 你 也 需要 告诉 Hibernate 要 返回 什么 映射 类 ， 
以 及 在 查询 中 引用 该 类 (及 其 属性 ) 的 别名 是 什么 。 


假设 我 们 想 知道 所 有 恰好 结束 在 半分 钟 的 曲目 ( 换 句 话说 ， 自 动 
唱片 机 系统 显示 的 播放 时 间 是 h: mm: 30) ， 不 过 ， 这 个 例子 有 点 做 
作 。 简 单 的 方法 就 是 使 用 HSQLDB 内 建 的 SECOND 函 数 ， 它 会 返 
Time 值 中 秒 数 的 部 分 。 由 于 HQL 不 知道 HSQLDB SQL 方言 中 这 一 特殊 
的 函数 ， 所 以 我 们 只 得 使 用 原生 的 SQL 查询 。 例 9-23 演 示 了 这 个 例子 
的 实现 ， 将 它 添加 到 Track.hbm.xml 中 的 HQL 查 询 之 后 。 


例 9-23: 在 Hibernate 映 射 文档 中 舱 入 一 个 原生 的 SQL 方 言 查询 


<sql-query name="com.oreilly.hh.tracksEndingAt" > 
<return alias="track"class="com.oreilly.hh.data.Track"/> 
<! [CDATA[ 

select{track.*} 

from TRACK as{track} 

where SECOND ({track}.PLAYTIME) =: seconds 


ate 
retum 标 签 是 告诉 Hibernate， 我 们 准备 在 查询 中 使 用 track 别 名 来 引 
用 Track 对 象 ， 这 样 束 能 够 在 查询 语句 中 使 用 简写 的 {track.*} 来 引用 
TRACK 数据 表 中 所 需要 的 所 有 字段 以 创建 Track 实例 (注意 ， 在 查询 
语句 中 这 样 使 用 别名 时 必须 用 大 括号 将 别名 括 起 来 。 这 能 让 我 们 * 脱 


离 ” 原 生 的 SQL 语句 环境 ， 用 Hibernate 映 映 类 和 属性 来 描述 得 询 内 


容 ) 。 


查询 中 的 where 子 句 使 用 了 HSQLDB SECONDINZCKR Wie Bis i 
果 ， 只 在 结果 中 保留 时 间 长 度 值 的 秒 数 部 分 有 具有 特定 值 的 曲目 。 闻 
好 ， 即 便 我 们 构建 了 一 个 原生 的 SQL 查询 ， 依 然 能 够 利用 Hibernate 很 
棒 的 命名 查询 参数 。 在 这 个 示例 中 ， 我 们 传递 了 一 个 名 为 "seconds" 的 
值 以 控制 查询 返回 的 结果 。 《即便 在 SQL 查询 中 ， 也 不 需要 使 用 大 括 

告诉 Hibernate 你 正在 使 用 命名 参数 。Hibernate 的 解析 堪 足 够 智 
能 ， 以 致 于 可 以 自动 明白 你 写 的 是 什么 。) 


使 用 该 映射 SQL 查询 的 代码 和 前 面 示例 中 使 用 HQL 碍 询 的 代码 并 
没有 什么 不 同 。 可 以 用 getNamedQuery () 方法 来 加 载 这 两 种 查询 ， 
而 且 这 两 种 查询 都 实现 了 Query 接 口 。 所 以 ， 调 用 该 查询 的 Java 方 法 看 
起 来 应 该 很 熟悉 。 将 例 9-24 中 的 代码 添加 到 QueryTestjava 中 
printTrackSummary () 方法 的 后 面 。 


例 9-24: 调用 原生 的 SQL 映射 查询 


SER 

*Print tracks that end some number of seconds into their final 
minute. 

* 


*@param seconds, the number of seconds at which we want tracks 
to end. 

*@param session the Hibernate session that can retrieve data. 

kk 


public static void printTracksEndingAt (int seconds, Session 
session) { 
Query query=session.getNamedQuery 
("com.oreilly.hh.tracksEndingAt") ; 
query.setInteger ("seconds", seconds) ; 
List results=query.list () ; 
for (ListIterator iter=results.listIterator () ; iter.hasNext 


Track track= (Track) iter.next () ; 
System.out.printin ("Track: "+track.getTitle () + 
", Llength="+track.getPlayTime () ) ; 


} 
} 


最 后 ， 在 main () 中 加 上 几 行 代码 以 调用 这 个 方法 。 例 9-25 演 示 
了 将 其 添加 到 对 printTrackSummary () 的 调用 之 后 的 样子 。 


例 9-25: 调用 printTracksEndingAt () 以 显示 终止 于 半分 钟 的 曲目 


printTrackSummary (CreateTest.getArtist ("Samuel Barber", 

false, session) , session) ; 

System.out.printin ("Tracks ending halfway through final 
minute: ") ; 

printTracksEndingAt (30, session) ; 

}finally{ 

//No matter what, close the session 


执行 ant dtest 命 令 后 ， 这 些 修改 会 产生 额外 的 输出 结 宁 ， 如 例 9-26 
所 示 。 


例 9-26: 原生 SQL 查 询 的 输出 示 


qtest: 
[java]Track: Video Killed the Radio Star[ID=2] 


[java]Summary of tracks by Samuel Barber: 
[java]Total tracks: 2 

[java]Shortest track: 00: 06: 35 

[java]Longest track: 00: 07: 39 

[java]Tracks ending halfway through final minute: 
[java]Track: Russian Trance, length=00: 03: 30 
BUILD SUCCESSFUL 

Total time: 10 seconds 


与 HQL 查 询 相 比 ， 使 用 原生 SQL 查询 时 需要 注意 更 多 不 同 层 次 上 
的 细节 ， 也 更 乏味 〈 尤 其 是 当 你 的 查询 变 得 复杂 或 涉及 对 多 个 数据 表 
的 引用 时 ) ,但 是 ， 它 偶尔 会 在 某 些 场合 真 的 可 以 派 上 用 场 ， 这 也 十 
一 件 好 事 。 


其 他 


从 Hibernate 3 起 ，sql-query 映 射 也 成 为 在 Hibernate 中 操纵 数据 库存 
储 过 程 的 入 口 点 (如 果 这 些 与 你 没什么 关系 ， 不 必 担 心 ， 这 只 是 意味 
着 你 现在 还 不 需要 为 它们 操心 ， 当 你 需要 使 用 它们 时 ， 就 会 知道 是 怎 
AEST) 。 对 于 可 以 调用 的 查询 的 种 类 ， 以 及 查询 可 以 返回 的 类 
型 ， 都 有 一 些 明 确 的 限制 ， 而 且 这 些 限制 会 随 着 数据 库 的 不 同 而 有 所 
不 同 。 更 详尽 的 细节 ， 可 以 查看 Hibernate 参 考 手册 (H) 


虽 ， 还 有 其 他 的 东西 吗 ? 你 会 怀疑 本 章 儿 乎 没有 谈 到 用 HQL 可 以 
做 些 什 么 。 的确 如 此 。 当 你 开始 结合 这 些 功能 ， 并 运用 集合 、 关 联 以 
及 功能 强大 的 表达 式 时 ， 丈 能 完成 一 些 令 人 刮目相看 的 事情 。 我 们 不 


可 能 在 这 本 介绍 性 的 图 书 中 涉及 方方面面 的 细节 ， 所 以 你 得 目 己 去 阅 
读 Hibernate 参 考 手 册 中 有 关 HQL 的 那 一 下 及 其 示例 ， 然 后 再 目 己 做 些 
实 


KH o 


当 你 阅读 Hibernate 参 考 手 册 中 有 关 "Hibernate Query Language" ( 
21) 的 那 一 章 时 ， 一 定 要 看 看 表达 式 中 能 用 到 的 那些 有 趣 的 事项 ， 尤 
其 是 与 集合 有 关 的 情况 。 别 忘 了 你 可 以 用 数组 括号 表示 法 来 选择 集合 
中 具有 特定 索引 值 的 元 素 ， 甚 至 可 以 在 括号 中 置 入 算术 表达 式 。 
Hibernate 参 考 手 册 的 HQL 那 一 章 在 见长 的 示例 之 后 ， 接 着 的 一 节 是 “小 \ 
技巧 和 小 窍门 ”(Tips and Tricks) ， 这 一 节 给 出 了 一 些 有 用 的 建议 ， 
谈 到 了 如 何在 不 同 数据 库 环 境 中 有 效 地 工作 ， 以 及 使 用 各 种 Hibernate 
接口 来 达到 你 想 都 想不到 的 效果 (如 果 你 有 SQL 使 用 基础 ， 就 更 是 如 
此 ) 。 你 也 可 以 仔细 研读 本 书 附 录 E 提 到 的 那些 图 书 。 希 望 这 里 的 讨 
论 能 够 帮助 你 英 定 好 基础 ， 并 能 作为 日 后 探索 研究 的 出 发 点 、 文 柱 以 
及 动机 |! 


注意 : 这 不 是 你 老 爸 那个 时 代 的 SQL.……. 


[1] 
http://www.hibernate.org/hib_docs/v3/reference/en/html_single/#sp_query. 


[2] http://www.hibernate.org/hib_docs/v3/reference/en/html/queryhql1.html. 


到 目前 为 止 ， 我 们 的 示例 只 涉及 除 Hibernate 以 外 非常 有 限 的 一 组 
TA: Ant > Maven Ant Tasks ` Hibernate Tools 以 及 我 们 的 关系 数据 库 
HSQLDB。 为 我 们 快速 地 “品尝 ”Hibernate 并 体验 它 的 主要 功能 而 提供 
一 个 平台 ， 这 些 工具 再 合适 不 过 了 “。 不 过 ， 在 现实 世界 中 ， 你 可 能 经 
常会 需要 以 不 同 的 方式 来 使 用 Hibernate， 并 与 其 他 有 用 的 工具 包 配 合 
使 用 。 


圣 好 ， 这 些 工 具 的 用 法 还 算 简 单 ! 所 以 我 们 换个 方向 ， 开 始 介绍 
一 些 狐 面孔 ， 比 如 流行 的 MySQL 数 据 库 和 Eclipse IDE (集成 开发 环 
境 ) 。 接 着 我 们 将 更 深入 地 讨论 Maven， 而 不 是 像 原 来 那样 ， 只 是 将 
它 作 为 让 示例 可 以 正常 工作 的 一 块 跳板 ， 演 示 了 一 些 比 Ant Tasks 更 为 
有 用 的 Maven 用 法 。 最 后 ， 我 们 将 重点 介绍 Spring 和 Stripes， 这 是 两 个 
非常 有 用 的 开源 项 目 ， 与 Hibernate 结 合 得 相当 完美 。 


第 10 章 ”将 Hibernate 连 接 到 MySQL 


建立 MySQL 数 据 库 


虽然 HSQLDB 是 一 个 漂亮 的 、 完 整 的 (self-contained) 数据 库 ， 
不 过 你 的 实际 项 目 可 能 并 不 需要 这 种 嵌入 式 的 Java 数 据 库 。 事 实 上 ， 
你 更 可 能 需要 同 某 些 现 有 的 、 外 部 的 数据 库 打 交道 。 邓 好， 这 也 没 什 
么 困难 的 〈 假 设 你 已 经 安装 好 了 数据 库 ， 并 可 以 让 它 正 常 运 行 起 来 ， 
不 过 ， 这 些 《安装 和 配置 ) 内 容 肯 定 不 在 本 书 讨论 的 范围 之 内 ) 。 


注意 : 这 个 例子 假设 你 已 经 有 了 一 个 可 运行 的 MySQL 实 例 ， 可 以 


管理 它 。 


为 了 突出 Hibernate 在 数据 库 选 择 上 的 灵活 性 ， 我 们 先 来 看 看 如 果 
想 让 Hibernate 连 接 到 MySQL 数 据 库 ， 应 该 怎么 修改 第 2 章 中 Hibernate 
的 配置 。 


应 该 怎么 做 


连接 到 MySQL 服 务 器 ， 创 建 一 个 新 的 数据 库 ， 如 例 10-1 所 示 。 
例 10-1: 建立 MySQL 数 据 库 notebook_db 


%mysql-u root-p 

Enter password: 

Welcome to the MySQL monitor.Commands end with; or\g. 

Your MySQL connection id is 3 to server version: 5.0.21 

Type'help; ‘or'\h'for help.Type'\c'to clear the buffer. 

mysql> CREATE DATABASE notebook_db; 

Query OK, 1 row affected (0.03 sec) 

mysql >GRANT ALL ON 
notebook_db.*TO'jim'@'janus.reseune. pvt ' IDENTIFIED 

BY's3cret'; 


Query OK, © rows affected (0.02 sec) 
mysql> quit; 
Bye 


注意 一 下 你 创建 的 数据 库 的 名 称 ， 以 及 授予 能 够 访问 它 的 用 户 名 
和 口令 ， 需 要 将 这 些 信息 输入 到 hibernate.cfg.xm] 配 置 文件 中 ， 如 稍 后 
的 例 10-3 所 示 〈 在 实际 的 数据 库 使 用 中 ， 和 希望 你 使 用 比 这 个 例子 的 口 
令 更 为 健壮 的 口令 ) 。 如 果 你 的 数据 库 服务 器 与 运行 示例 代码 的 计算 
机 不 是 同一 台 机 器 ， 那 么 需要 将 GRANT 命 令 行 中 的 localhost 替 换 为 用 
于 运行 示例 的 机 器 的 主机 名 《或 者 ， 如 果 你 是 在 一 个 相对 安全 的 私有 
网 络 中 ， 那 么 还 可 以 使 用 “%” 来 表示 容许 接受 任何 主机 的 访问 ) 。 


连接 到 MySQL 


接 下 来 ， 我 们 需要 用 一 个 JDBC 驱 动 程序 才能 够 连接 到 MySQL 。 
为 了 获取 这 个 驱动 程序 ， 可 以 在 build.xml 中 再 添加 一 个 依赖 ， 如 例 10- 
2 所 示 。 对 于 几 种 不 同 的 数据 库 ， 都 有 它们 各 自 可 供 使 用 的 驱动 程序 ， 
这 一 点 不 错 。 这 些 不 同 的 驱动 程序 不 会 冲突 ， 因 为 Hibernate 配 置 文件 
会 指定 最 终 使 用 哪个 驱动 程序 (如 果 你 对 如 何 “ 手 工 ” 获 取 这 种 驱动 程 
序 感到 好 奇 ， 那 么 可 以 从 MySQL 的 官方 网 站 (1) FE 
Connector/J) 。 不 过 ， 如 采 你 想 避 免 以 后 Hibernate 配 置 文件 的 读者 会 
感到 这 部 分 有 些 混 乱 ， 则 可 以 放心 地 删除 <hsqldb > 依赖 和 < db> 构 
建 目 标 ， 因 为 以 后 不 再 需要 用 GUI (图 形 用 户 界面 ) 查看 HSQLDB 中 
的 数据 了 。 


例 10-2: 在 build.xml 中 添加 对 MySQL 驱 动 程序 的 项 目 依 赖 


<artifact: dependencies pathId="dependency.class.path"> 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="mysql"artifactId="mysql-connector-java" 

version="5.0.5"/> 

<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 


说 到 配置 文件 ， 现 在 就 应 该 编辑 hibernate.cfg.xml， 以 使 用 新 的 驱 
动 程序 和 我 们 刚才 创建 的 数据 库 了 。 例 10-3 演 示 了 如 何 使 用 前 面 例 10- 
1 创建 的 数据 来 建立 到 我 自己 的 MySQL 数 据 库 实例 的 连接 。 你 需要 根 
据 你 自己 的 数据 库 服务 器 、 数 据 库 以 及 你 所 选择 的 登录 身份 认证 来 调 
整 这 些 数据 库 连 接 的 配置 值 (如 果 你 使 用 的 是 MM.MySQL， 则 应 该 使 
用 旧版 的 MySQL JDBC 驱 动 程序 ， 相 应 的 驱动 程序 类 名 称 应 该 是 


com.mysql.jdbc.Driver) ° 


还 需要 删除 配置 文件 底部 的 jdbc.batch_size 属 性 。 报 告 来 自 批 处 理 
内 的 实际 问题 ，MySQL 了 驱动 程序 没有 任何 问题 ， 与 进程 外 (out-of- 
process) 数据 库 相 比 ， 对 于 前 面 使 用 的 HSQLDB 了 驱动 程序 ， 如 果 关 闭 
这 个 批 处 理 选 项 ， 则 会 对 性 能 造成 很 大 的 不 良 影响 。 


例 10-3: 修改 hibernate.cfg.xml 以 连接 到 新 的 MySQL 数 据 库 


<?xml version='1.0'encoding='utf-8'?> 

<! DOCTYPE hibernate-configuration PUBLIC 

"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-configuration- 
3.0.dtd"> 

<hibernate-configuration> 

<session-factory> 

<! --SQL dialect--> 

<property name="dialect">org.hibernate. dialect .MySQL5Dialect 
</property> 

<! --Database connection settings--> 

<property name="connection.driver_class">com.mysql.jdbc.Driver 
</property> 

<property 

name="connection.url">jdbc: mysql: //localhost/notebook_db 
</property> 

<property name="connection.username" > jim</property> 


<property name="connection.password">s3cret</property> 
<property name="connection.shutdown" >true</property> 


如 果 不 是 在 运行 测试 示例 的 机 右上 运行 MySQL ， 而 是 在 另外 的 机 
郁 上 运行 MYSQL， 则 第 三 个 属性 定义 必须 能 够 反映 出 你 的 数据 库 服务 
器 的 名 称 。 另 外 ，connection.shutdown 配 置 属性 也 不 再 需要 了 ， 不 过 ， 
放 在 那里 也 没什么 影响 。 


[1] http://www.mysql.com/products/connector/j/. 


尝试 一 下 


一 切 准 备 好 以 后 ， 再 回 到 第 2.3 节 建立 的 那个 数据 库 模 式 创 建 的 示 
例 。 这 一 次 它 应 该 在 MySQL 服 务 器 上 创建 数据 库 模 式 ， 而 不 是 在 嵌入 
式 HSQLDB 中 。 数 据 库 模式 创建 的 输出 如 例 10-4 所 示 ， 不 过 ， 实 际 输 
出 的 内 容 要 比 这 个 例子 列举 的 内 容 还 要 长 ， 所 以 就 删除 了 部 分 重复 和 
繁琐 的 输出 ， 以 突出 一 些 特别 重要 的 片段 ， 通 过 它们 来 证 明 我 们 的 新 
设置 已 经 生效 了 (注意 ， 我 们 以 一 个 单独 的 ant prepare 调 用 作为 开始 ， 
因为 这 是 我 们 第 一 次 在 本 章 的 示例 目录 运行 程序 ， 在 Ant 第 一 次 开始 运 
行 schema 构 建 目标 时 ， 我 们 需要 将 正确 的 文件 放 在 类 路 径 上 ) 。 


例 10-4: 连接 MySQL 并 创建 数据 库 模 式 


%ant prepare 

Buildfile: build.xml 

Downloading: mysql/mysql-connector-java/5.0.5/mysql-connector - 
java-5.0.5.pom 

Transferring 1K 

Downloading: mysql/mysql-connector-java/5.0.5/mysql-connector - 
java-5.0.5.jar 

Transferring 500K 

prepare: 

[mkdir ]Created 
dir: /Users/jim/svn/oreilly/hibernate/current/examples 

/chi0/classes 

[copy]Copying 5 files to/Users/jim/svn/oreilly/hibernate/current 

/examples/ch1i0/classes 

BUILD SUCCESSFUL 

Total time: 3 seconds 

%ant schema 

Buildfile: build.xml 


prepare: 

usertypes: 

[javac]Compiling 2 source files 
to/Users/jim/svn/oreilly/hibernate 

/current/examples/chi0/classes 

codegen: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]i.task: hbm2java (Generates a set of.java files) 

[hibernatetool]16: 46: 38, 403 INFO Environment: 514-Hibernate 
3.2.5 

[hibernatetool]16: 46: 38, 415 INFO Environment: 547- 
hibernate. properties 

not found 

[hibernatetool]16: 46: 38, 419 INFO Environment: 681-Bytecode 
provider name 

: cglib 

[hibernatetool]16: 46: 38, 434 INFO Environment: 598-using JDK 
1.4 java. 

sql.Timestamp handling 

[hibernatetool]16: 46: 38, 561 INFO Configuration: 1460- 
configuring from 

file: hibernate.cfg.xml 

[hibernatetool]16: 46: 38, 740 INFO Configuration: 553-Reading 
mappings 

from resource: com/oreilly/hh/data/Track.hbm. xml 

[hibernatetool]16: 46: 38, 932 INFO HbmBinder: 300-Mapping class: 
com 

.oreilly.hh.data.Track- > TRACK 

[hibernatetool]16: 46: 39, 110 INFO HbmBinder: 1422-Mapping 
collection: 

com.oreilly.hh.data.Artist.tracks- >TRACK_ARTISTS 

[hibernatetool]16: 46: 39, 239 INFO Configuration: 1541- 
Configured SessionFactor 

y: null 

[hibernatetool]16: 46: 39, 411 INFO Version: 15-Hibernate Tools 
3.2.0.b9 

compile: 

[javac]Compiling 9 source files 
to/Users/jim/svn/oreilly/hibernate 

/current/examples/chi0/classes 

schema: 

[hibernatetool]Executing Hibernate Tool with a Standard 
Configuration 

[hibernatetool]i.task: hbm2dd1 (Generates database schema) 

[hibernatetool]16: 46: 41, 502 INFO Configuration: 1460- 
configuring from 


file: hibernate.cfg.xml 

[hibernatetool]16: 46: 41, 515 INFO Configuration: 553-Reading 
mappings 

from resource: com/oreilly/hh/data/Track.hbm. xml 

[hibernatetool]16: 46: 41, 629 INFO Configuration: 1541- 
Configured SessionFactor 

y: null 

[hibernatetool]16: 46: 41, 659 INFO Dialect: 152-Using dialect: 
org.hibernate 

.dialect .MySQL5Dialect 

[hibernatetool]16: 46: 41, 714 INFO SchemaExport: 154-Running 
hbm2dd1 

schema export 

[hibernatetool]16: 46: 41, 716 INFO SchemaExport: 179-exporting 
generated 

schema to database 

[hibernatetool]16: 46: 41, 725 INFO 
DriverManagerConnectionProvider: 41-Using 

Hibernate built-in connection pool (not for production use! ) 

[hibernatetool]16: 46: 41, 726 INFO 
DriverManagerConnectionProvider: 42-Hibernat 

e connection pool size: 1 

[hibernatetool]16: 46: 41, 727 INFO 
DriverManagerConnectionProvider: 45-autocomm 

it mode: false 

[hibernatetool]16: 46: 41, 745 INFO 
DriverManagerConnectionProvider: 80-using 

driver: com.mysql.jdbc.Driver at URL: jdbc: 
mysql: //localhost/notebook_db 

[hibernatetool]16: 46: 41, 746 INFO 
DriverManagerConnectionProvider: 86- 

connection properties: {user=jim, password=****, shutdown=true} 

[hibernatetool]alter table ALBUM_ARTISTS drop foreign key 
FK7BA403FC76BBFFF9Q9; 

[hibernatetool]Jalter table TRACK_COMMENTS drop foreign key 
FK105B2688E424525B; 

[hibernatetool]drop table if exists ALBUM; 

[hibernatetool]drop table if exists ALBUM_ARTISTS; 

[hibernatetool]drop table if exists ALBUM_COMMENTS; 

[hibernatetool]drop table if exists ALBUM_TRACKS; 

[hibernatetool]drop table if exists ARTIST; 

[hibernatetool]drop table if exists TRACK; 

[hibernatetool]drop table if exists TRACK_ARTISTS; 

[hibernatetool]drop table if exists TRACK_COMMENTS; 

[hibernatetool]create table ALBUM (ALBUM_ID integer not null 
auto_increment, TI 


TLE varchar (255) not null, numDiscs integer, added date, primary 
key (ALBUM_ID) ) 


[hibernatetool]create table ALBUM_ARTISTS (ALBUM_ID integer not 
null, ARTIST_ID 
integer not null, primary key (ALBUM_ID, ARTIST_ID) ) ; 
[hibernatetool]create table ALBUM_COMMENTS (ALBUM_ID integer not 
null, COMMENT 
varchar (255) ) ; 
[hibernatetool]create table ALBUM_TRACKS (ALBUM_ID integer not 
null, TRACK_ID 
integer, disc integer, positionOnDisc integer, LIST_POS integer 
not null, primary 
key (ALBUM_ID, LIST_POS) ) ; 
[hibernatetool]create table ARTIST (ARTIST_ID integer not null 
auto_increment, 
NAME varchar (255) not null unique, actualArtist integer, primary 
key (ARTIST_ID) 
eS 
[hibernatetool]create table TRACK (TRACK_ID integer not null 
auto_increment, TI 
TLE varchar (255) not null, filePath varchar (255) not null, 
playTime time, added 
date, VOL_LEFT smallint, VOL_RIGHT smallint, sourceMedia varchar 
(255) , 
primary key (TRACK_ID) ) ; 
[hibernatetool]create table TRACK_ARTISTS (TRACK_ID integer not 
null, ARTIST_ID 
integer not null, primary key (TRACK_ID, ARTIST_ID) ) ; 
[hibernatetool]create table TRACK_COMMENTS (TRACK_ID integer not 
null, COMMENT 
varchar (255) ) ; 
[hibernatetool]create index ALBUM_TITLE on ALBUM (TITLE) ; 
[hibernatetool]Jalter table ALBUM_ARTISTS add index 
FK7BA403FC76BBFFF9 (ARTIST_ID) , 
add constraint FK7BA403FC76BBFFF9 foreign key (ARTIST_ID) 
references ARTIST 
(ARTIST_ID) ; 
[hibernatetool]Jalter table ALBUM_ARTISTS add index 
FK7BA403FCF2AD8FDB (ALBUM_ID) , 
add constraint FK7BA403FCF2AD8FDB foreign key (ALBUM_ID) 
references ALBUM 
(ALBUM_ID) ; 
[hibernatetool]Jalter table ALBUM_COMMENTS add index 
FK1E2C21E4F2AD8FDB 
(ALBUM_ID) , add constraint FK1E2C21E4F2AD8FDB foreign key 
(ALBUM_ID) references 
ALBUM (ALBUM_ID) ; 


[hibernatetool]alter table ALBUM_TRACKS add index 
FKD1ICBBC78E424525B 
(TRACK_ID) , add constraint FKD1CBBC78E424525B foreign key 
(TRACK_ID) references 
TRACK (TRACK_ID) ; 
[hibernatetool]Jalter table ALBUM_TRACKS add index 
FKD1ICBBC78F2AD8FDB 
(ALBUM_ID) , add constraint FKD1CBBC78F2AD8FDB foreign key 
(ALBUM_ID) references 
ALBUM (ALBUM_ID) ; 
[hibernatetool]create index ARTIST_NAME on ARTIST (NAME) ; 
[hibernatetool]Jalter table ARTIST add index FK7395D347A1422D3B 
(actualArtist) , 
add constraint FK7395D347A1422D3B foreign key (actualArtist) 
references 
ARTIST (ARTIST_ID) ; 
[hibernatetool]create index TRACK_TITLE on TRACK (TITLE) ; 
[hibernatetool]Jalter table TRACK_ARTISTS add index 
FK72EFDAD8E424525B 
(TRACK_ID) , add constraint FK72EFDAD8E424525B foreign key 
(TRACK_ID) references 
TRACK (TRACK_ID) ; 
[hibernatetool]Jalter table TRACK_ARTISTS add index 
FK72EFDAD876BBFFF9 
(ARTIST_ID) , add constraint FK72EFDAD876BBFFF9 foreign key 
(ARTIST_ID) 
references ARTIST (ARTIST_ID) ; 
[hibernatetool]Jalter table TRACK_COMMENTS add index 
FK105B2688E424525B 
(TRACK_ID) , add constraint FK105B2688E424525B foreign key 
(TRACK_ID) references 
TRACK (TRACK_ID) ; 
[hibernatetool]16: 46: 42, 630 INFO SchemaExport: 196-schema 
export complete 
[hibernatetool]16: 46: 42, 631 INFO 
DriverManagerConnectionProvider: 147-cleanin 
g up connection pool: jdbc: mysql: //localhost/notebook_db 
[hibernatetool]9 errors occurred while performing<hbm2ddl1>. 
[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.album_artists'doesn't exist 
[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.album_artists'doesn't exist 
[hibernatetool]Error#1: 
com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.album_comments'doesn't exist 


[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.album_tracks'doesn't exist 
[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.album_tracks'doesn't exist 
[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.artist'doesn't exist 
[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.track_artists'doesn't exist 
[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.track_artists'doesn't exist 
[hibernatetool]Error#1: 

com.mysql.jdbc.exceptions .MySQLSyntaxErrorException: T 
able 'notebook_db.track_comments'doesn't exist 
BUILD SUCCESSFUL 
Total time: 8 seconds 


AE TAT A 


Hibernate 会 自行 配置 和 使 用 avail 能 ， 检 查 我 们 的 Track 
类 的 映射 文档 ， 连 接 到 MySQL 服 务 器 ， 执 行 必要 的 命令 以 创建 供 持久 
化 我 们 的 示例 数据 所 需要 的 数据 库 模 式 《和 以 前 一 样 ， 最 后 会 报告 几 
个 SQL 异常 ， 你 可 以 忽略 它们 ; 这些 异常 可 能 是 因为 Hibernate 试 图 删 
除 并 不 存在 的 外 键 而 引起 的 ， 因 为 这 是 我 们 首次 党 试 创 建 数 据 库 模 
HL) 


再 次 说 明 一 下 ， 不 必 担 心 最 后 出 现 的 错误 ， 这 些 错误 是 由 于 为 了 
防止 已 经 存在 部 分 数据 库 模式 ，Hibernate 抢 先 试图 删除 它们 而 造成 


的 。 即 便 报 告 有 错误 ，Hibernate 并 不 认为 它们 会 造成 问题 ， 所 以 继续 
处 理 剩 下 的 数据 库 模 式 创 建 任 务 ， 并 最 终 报 告 操作 成 功 完成 。 


把 这 个 示例 和 HSQLDB 版 本 的 数据 库 模 式 创 建 ( 例 2-7) 进行 比 
较 ， 结 果 会 很 有 趣 。 它 们 的 输出 差不多 是 相同 的 ， 但 是 用 于 创建 数据 
库 表 的 SQL 语句 明显 不 同 。 这 就 是 Hibernate 中 所 请 的 SQL"“ 方 言 ”。 


查询 数据 


有 了 数据 库 服务 器 ， 你 束 可 以 再 次 运行 MySQL 客 户 端 ， 确 认 已 经 
创建 好 了 Track 类 映射 的 数据 库 模式 ， 结 采 如 例 10-5 所 示 。 


例 10-5: 检查 新 创建 的 MySQL 数 据 库 模式 


% mysql -u jim -p 

Enter password: 

Welcome to the MySQL monitor. Commands end with ; or \g. 
Your MySQL connection id is 21 to server version: 5.0.27 


Type 'help;' or '\h' for help. Type '\c' to clear the buffer. 


mysql> use notebook_db 

Reading table information for completion of table and column names 
You can turn off this feature to get a quicker startup with -A 
Database changed 


mysql> show tables; 


| ALBUM_ARTISTS | 
| ALBUM_COMMENTS | 
| ALBUM_TRACKS | 
| ARTIST | 
| TRACK_ARTISTS | 
| TRACK_COMMENTS | 
| album | 
| | 


8 rows in set (0.00 sec) 


mysql> describe track; 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
| Field | Type | Null | Key | Default | Extra 

+ 一 一 一 一 -一 一 一 一 一 一 -一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 + 一 一 一 一 一 + 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
| TRACK_ID | int(11) | NO | PRI | NULL | auto_increment 
i ERE | varchar(255) | NO | MUL | | 

| filePath | varchar(255) | NO | | | 

| playTime | time | YES | | NULL | 


added date | XES | NULL | | 
VOL_LEFT smallint (6) | YES | NULL | | 
VOL_RIGHT smallint (6) | YES | NULL | | 
sourceMedia varchar(255) | YES | NULL | | 
- 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
8 rows in set (0.03 sec) 
mysql> select from TRACK 
Empty set (0.00 sec) 
mysql> describe album_tracks 
+ 一 一 一 一 = 一 一 一 十 十 一 一 一 + + 一 一 一 一 一 一 十 一 一 一 一 一 一 一 十 
Field Type Null Key Default Extra 
+ 一 一 一 十 一 一 十 一 一 一 一 一 一 十 一 一 十 a+ 
ALBUM_ID er LE NO PRI | 
TRACK_ID int (11) YES MUL | NULL 
disc int<(11) YES NULL 
positionOnDisc int (11) YES NULL | 
LIST_POS int (11) NO PRI | 
+ 一 一 一 一 一 = 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 + 十 一 一 一 一 一 一 十 一 一 一 一 一 一 一 十 


5 rows in set (0.00 sec) 


mysql> quit; 


Bye 


ACHE TR Hee EA, THE ANET EE © WRR PPLE RY H RPE 
行 ant ctest 命 令 ， 接 着 再 尝试 做 个 select 查 询 ， 将 会 看 到 类 似 例 10-6 所 示 
的 数据 。 只 需要 修改 一 个 Hibernate 使 用 的 配置 文件 ， 就 可 以 完全 切换 
所 使 用 的 数据 库 。 当 项 目 进行 中 客户 多 次 提出 要 改变 他 们 需要 的 数据 
来 源 时 ， 或 是 多 位 开发 人 员 各 上 自 喜 欢 使 用 不 同 的 操作 系统 时 ， 以 这 种 
方式 来 修改 配置 显得 非常 方便 。 


例 10-6: 在 运行 ctest 构 建 目 标 后 ， 查 询 TRACK 数 据 库 表 


dees os Soe een oe A FP a SS RE S 
一 一 十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
TRACK_ID | TITLE | filePath 
| playTime added | VOL_LEFT | VOL_RIGHT | sourceMedia | 
RE ER 
一 一 十 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
1 Russian Trance vol2/album610/track02.mp 
3 | 00:03:30 2007-09-22 100 100 CD 
2 Video Killed the Radio Star vol2/album611/track12.mp 
3 | 00:03:49 2007-09-22 100 100 VHS 
3 Gravity's Angel vol2/albumi175/track03.mp 
3 | 00:06:06 2007-09-22 100 100 CD 
4 Adagio for Strings (Ferry Corsten Remix) vol2/album972/track01.mp 
3 | 00:06:35 2007-09-22 100 100 CD 
5 Adagio for Strings (ATB Remix) vol2/album972/track02.mp 
2 {| OOS07239 2007-09-22 100 100 CD 
6 The World '99 vol2/singles/pvw99.mp3 
| 00:07:05 2007-09-22 100 100 STREAM 
| 7 | Test Tone 1 | vol2/singles/test01.mp3 
| 00:00:10 | 2007-09-22 | 50 | 75 | NULL | 
+ 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 —------- 
十 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 十 十 一 一 一 一 一 一 二 


7 rows in set (0.00 sec) 


其 他 


在 图 形 界面 中 使 用 MySQL? 如 果 你 喜欢 使 用 像 我 们 在 演示 
HSQLDB 时 用 的 那 种 图 形 界面 工具 ， 可 以 试 试 MySQL GUI 工具 ， 可 以 
从 http:/devmysql.com/downloads/gui-tools/5.0.html 下 载 它 。 


连接 到 Oracle 数 据 库 ， 或 其 他 你 喜欢 的 数据 库 ， 或 是 共享 的 、 遗 留 
的 数据 库 ， 总 之 不 是 MySQL 或 HSQLDB 数 据 库 ? 你 可 能 已 经 想到 连接 
到 其 他 数据 库 也 同样 很 简单 ， 所 有 需要 做 的 就 是 修改 hibernate.cfg.xml 
中 的 hibernate.dialect 属 性 ， 以 反映 你 想 使 用 的 那 种 数据 库 。 可 供 选 用 的 


数据 库 方 言 有 许多 种 ， 差 不 多 已 经 包括 了 我 能 够 想得到 的 每 种 免费 的 
和 商业 的 数据 库 。 附 孙 C 列 出 了 在 编写 本 书 时 Hibernate 能 够 文 持 的 所 有 
数据 库 方言 ， 不 过 还 是 应 该 查阅 Hibernate 的 官方 文档 以 得 到 最 新 的 列 
表 。 如 有 果 你 想 使 用 比较 冷 俱 的 数据 库 ， 那 可 能 殉 得 目 己 编写 文 持 它 的 
数据 库 方言 了 ， 但 是 这 种 情况 看 起 来 不 太 可 能 发 生 (最 好 先 查 查 是 否 
已 经 有 人 开始 为 之 付出 努力 了 ) ° 


在 选择 好 使 用 哪 种 数据 库 方言 以 后 ， 还 需要 正确 设置 
hibernate.connection 的 各 个 属性 (driver、URL、username 以 及 
password) ， 才 可 以 建立 连接 到 你 所 选择 的 数据 库 环境 的 JDBC 连 接 。 
如 果 你 是 在 移植 现 有 的 项 目 以 使 用 Hibernate， 同 可 以 从 项 目的 代码 或 
配置 中 得 到 这 些 信 息 。 而 且 自 然 地 ， 在 项 目 构建 和 运行 期 间 ， 必 须 提 
供 项 目 依 赖 的 JDBC 驱 动 程序 。 


当然 ， 如 果 你 正在 连接 一 个 现 有 的 或 共享 的 数据 库 ， 就 不 必 使 用 
Hibernate 来 创建 数据 库 模 式 了 。 相 反 ， 这 时 你 需要 编写 Hibernate 映 射 文 
档 ， 以 便 将 现 有 的 数据 库 模 式 映射 到 持久 化 类 。 这 一 步 可 以 手工 完 
成 ， 或 者 使 用 Hibernate Tools (我 们 将 在 第 11 章 深入 研究 这 一 工具 ) 的 
帮助 ， 还 可 以 使 用 像 Middlegen (1) 之 类 的 第 三 方 工具 包 ， 之 后 就 可 
以 按 持 久 化 对 象 的 形式 来 使 用 数据 了 。 


使 用 Hibernate 甚 至 还 可 以 同时 与 多 种 不 同 的 数据 库 进 行 交 互 ， 只 
需要 用 单独 的 配置 文件 来 创建 多 个 会 话 工厂 实例 。 这 样 的 使 用 方法 已 


经 超出 了 本 书 所 要 演示 的 简单 、 目 动 化 的 配置 匈 围 ， 不 过 ，Hibernate 
参考 文档 中 有 这 方面 的 例子 。 当 然 ， 在 某 一 时 刻 ， 一 个 持久 化 对 象 只 
能 与 一 个 会 话 实 例 相 关联 ， 这 意味 着 一 个 持久 化 对 象 一 次 只 能 链接 到 
一 个 数据 库 。 不 过 ， 即 使 不 同 的 数据 库 使 用 不 同 的 模式 来 表示 持久 化 
类 ， 还 是 可 以 通过 精心 设计 的 编码 ， 实 现在 不 同 的 数据 库 系 统 之 间 复 
制 或 移动 对 象 。 当 然 ， 这 样 复 杂 的 处 理 更 是 超出 本 书 的 讨论 范围 了 ! 


[1] http://boss.bekk.no/boss/middlegen/. 


第 11 章 Hibernate Eclipse: Hibernate Tools 使 用 
实战 


{Eclipse 242Hibernate Tools 


如 果 你 是 使 用 Eclipse 作为 Java 开 发 环境 (现在 很 多 开发 人 员 都 在 使 
AE (Ul) ) ， 和 本 书 其 他 部 分 对 这 一 工具 的 使 用 (我 们 原来 用 它 为 
Ant 构 建 处 理 增 加 Hibernate 相 关 的 功能 ) 相 比 ， 在 Eclipse 中 可 以 更 加 充 
分 地 使 用 Hibernate Tools。 


应 该 上 怎么 做 


在 深入 讨论 以 前 ， 先 需要 保证 你 使 用 的 Eclipse 的 版 本 足够 新 。 目 
Hl Hibernate Tools 的 发 行 版 本 至 少 需要 Eclipse 3.3 和 WTP 2.0。 所 以 ， 如 
果 你 的 版 本 不 够 新 ， 没 有 理由 不 借 这 个 机 会 更 新 一 下 。 


在 Eclipse 中 安装 Hibernate Tools 最 简单 的 方法 就 是 通过 Eclipse 普 通 
的 网 站 更 新 机 制 。 首 先 需 要 告诉 Eclipse 到 哪 找 Hibernate Tools, 
在 "Software Update" 菜 单 中 选择 "Find and Install" 荣 单项 ， 如 图 11-1 所 


修 ° 


Window 


Welcome 


(?) Help Contents 
Search 
Dynamic Help 


Key Assist... T #L 
Tips and Tricks... 

4) Report Bug or Enhancement 
Cheat Sheets... 


Software Updates 2° Find and Install... 
r ®© Manage Configuration 


图 11-1 Eclipse 的 更 新 功能 


我 们 现在 需要 安装 全 新 的 一 个 插件 ， 而 不 是 更 新 现 有 的 插件 ， 所 
以 在 接 下 来 的 窗口 中 应 该 选择 "Search for new features to instal", FA, 
ii "Next" ° 


Eclipse 上 自己 不 会 自动 知道 Hibernate Tools 更 新 网 站 ， 所 以 我 们 需要 
告诉 它 到 哪 去 找 。 点 击 "New Remote Site"， 如 图 11-2 所 示 。 


Update sites to visit 
| Select update sites to visit while looking for new features. 


Sites to include in search: 

Al Eclipse Modeling Framework (EMF) Updates 

a Eclipse Modeling Framework Technologies (EMFT) U 
| Europa Discovery Site 

J] Model Developement Tools (MDT) Updates 

@] The Eclipse Project Updates 

@] Web Tools Platform (WTP) Updates 


= 
= 
= 
= 
B 
z 


v ignore features not applicable to this environment 
[C] Automatically select mirrors 


图 11-2 在 Eclipse 中 从 一 个 新 的 更 新 网 站 来 安装 插件 


输入 一 些 描 述 性 的 文字 (如 "Hibermnate Tools") ， 以 作为 新 的 更 新 
网 站 的 名 称 。Edlipse 现 在 需要 我 们 指定 更 新 网 站 的 URL， 如 稍 后 的 图 
11-4 所 示 。 我 们 必需 在 网 上 搜索 一 下 ， 才 能 找到 正确 的 更 新 URL © 


切换 到 Web 浏 贤人 器 ， 打 开 Hibernate 网 站 http://hibernate.org， 在 页 面 
左边 的 导航 菜单 中 点 击 "Hibernate Tools”( 或 者 ， 你 也 可 以 直接 打开 
http://tools.hibernate.org 这 个 目录 链接 ) 。 在 打开 页 面 以 后 ， 可 以 看 看 有 


天 这 一 工具 的 介绍 ， 以 及 各 种 文档 链接 。 我 们 在 第 一 次 研究 怎么 把 这 
个 工具 安装 到 Edlipse 中 时 ， 还 花 了 些 时 间 ， 最 后 才 发 现 我 们 错过 了 一 
直 要 找 的 东西 ， 在 Tools 页 面 上 原本 束 有 一 个 更 新 网 站 链接 。 将 这 个 链 
接 的 URL 复 制 到 剪 切 板 ， 如 图 11-3 所 示 《在 链接 上 用 鼠标 右键 点 击 或 按 
住 Ctl 键 点 击 ， 就 可 以 打开 上 下 文 关联 菜单 ) 。 


Hibernate Tools for Eclipse and Ant 


Project Lead: Max R. Andersen 
Contributors: Mark Hobson, Marshall Culpepper, David Channon, Joe Hudson and others 
Latest release: 3.2.0.GA (What's New?) 

Release date: 12.12.2007 

Update site: Hibernate Tools only & JBoss Tools 

Nightly Build: JBoss Tools 
Documentation: Reference, Viewlets, Build & Contr 
Requirements: Eclipse WTP 3.3/2.x or Ant, Dece 


Open Link in New Window 
Open Link in New Tab 


Download Linked File 
Download Linked File As... 
Add Link to Bookmarks... 


for an overview of the Hibernate 2.x toolset), imple 
for integration into the build cycle. Hibernate Tools 
Studio. See the documentation and screenshots for 


The following features are available within Eclipse: Copy Link 
Mapping Editor: An editor for Hibernate XML mapp 


In Elemen 
completion and syntax highlighting. The editor eve spect Klement j 


completion for class names, property/field names, tat 


图 11-3 获取 Hibernate Tools 更 新 的 网 站 URL 


如 果 你 仔细 观察 ， 可 能 会 注意 到 这 个 页 面 上 Hibernate Tools 的 版 本 
要 比 我 们 这 本 书 使 用 的 版 本 (3.2.0 Betada) 还 新 。 不 错 ， 你 现在 应 该 
明日 像 Hibernate 这 样 大 型 开源 项 目 变 化 得 太 快 了 ， 写 本 关于 它 的 书 有 
多 么 难 ! 在 编写 本 书 时 ，Hibernate Tools 的 稳定 版 本 才刚 推出 ，Maven 
库 中 还 未 提供 对 这 个 版 本 的 支持 ， 所 以 我 们 现在 先 不 用 管 本 书 原来 使 


FAH Hibernate Tools。 无 论 如 何 ， 新 版 本 的 变化 都 不 会 影响 其 他 章节 的 
示例 ， 只 是 Eclipse 的 当前 最 新 版 本 〈 编 写本 书 时 的 版 本 是 3.3， 也 称 为 
Europa) 需要 配合 使 用 Hibernate Tools 的 最 新 版 本 ， 这 样 才 可 以 支持 本 


章 将 要 演示 的 一 些 功 能 。 


将 更 新 网 站 的 URL 复 制 粘贴 到 Eclipse 的 "New Update Site" 窗 口中 ， 
如 图 11-4 所 示 。 点 击 "OK" 按 钮 ， 以 确认 保存 这 个 新 的 网 站 URL 。 


800 New Update Site 


| Name: Hibernate Tools 


itp: / /download.jboss.org/jbosstools/updates/stable 


图 11-4 在 Eclipse 中 配置 一 个 新 的 更 新 网 站 


从 图 11-5 中 可 以 看 到 ，Eclipse 合 理 地 假设 你 想 使 用 刚才 配置 的 更 新 
网 站 ( 勾 选 了 Hibernate Tools) ， 所 以 ， 这 时 只 要 点 击 "Finish" 按 钮 ， 
Eclipse 束 会 自动 连接 更 新 网 站 ， 检 查 从 那 可 以 安装 的 插件 。 


接着 会 弹出 一 个 窗口 (如 图 11-6 所 示 ) ， 这 个 窗口 比较 简单 ， 它 的 
出 现 就 表明 胜利 在 望 了 。 所 有 我 们 需要 做 的 就 是 勾 选 Hibernate Tools 节 
点 旁边 的 复 选 框 ， 现 在 就 安装 ， 对 吗 ? 


1 om 
Update sites to visit 
| Select update sites to visit while looking for new features. 


install 


Sites to include in search: 


| | Eclipse Modeling Framework (EMF) Updates ( New Remote Site... — 


日 | Eclipse Modeling Framework Technologies (EMFT) U! 


E) A uropa icover sr i 


v 十 Hibernate Tools | 

日 全 Model Developement Tools (MDT) Updates | 
回 A] The Eclipse Project Updates 

T @] Web Tools Platform (WTP) Updates 


图 11-5 新 的 更 新 网 站 已 经 准备 好 使 用 


08 Updates 
Search Results 


Q. SeamTools Feature (2.0.0.GA) requires feature 
"org.eclipse.datatools.connectivity.feature”. 


Select the features to install: 
1 Hibernate Tools 


10 of 10 selected. 
Vv Show the latest version of a feature only 


[_] Filter features included in other features on the list 


@) C < Back j é Next > 3 4 Finish) 
A 


图 11-6 正在 安装 Hibernate Tools: 我 们 需要 再 接 再 历 


很 不 走运 ， 当 我 们 选中 Hibernate Tools 闻 点 旁边 的 复 选 框 时 ， 亿 到 
了 麻烦 。 这 个 窗口 顶部 显示 了 一 条 错误 消息 ，"Next" 按 钮 也 变 成 了 灰 
色 ， 不 让 我 们 继续 使 用 了 。 


出 了 什么 问题 


Eclipse 不 让 我 们 继续 安装 ， 是 因为 SeamTools 功 能 (组 成 Hibernate 
Tools 工 具 集 的 10 个 插件 之 一 ) 需要 安装 其 他 插件 
(org.eclipse.datatools.connectivity.feature) ， 而 且 这 些 插件 还 不 能 默认 
安装 。 非 常 不 地， 我 们 只 得 后 退 几 步 。 点 击 "Cancel" 按 钮 ， 再 从 本 万 开 
台 介 绍 的 "Find and Install" 染 单 选项 开始 。 再 一 次 选择 "Search for new 
features to install"， 点 击 "Next"。 这 次 要 选中 Europa Discovery Site 1) 
点 ， 如 图 11-7 所 示 ， 再 点 击 "Finish" 按 钮 。 


e608 Install 
Update sites to visit 


Select update sites to visit while looking for new features. 


Sites to include in search: 


= Eclipse Modeling Framework (EMF) Updates 

C @ Eclipse Modeling Framework Technologies (EMFT) Updates 
wv | Europa Discovery Site 

Ww a Hibernate Tools 

日 @] Mode! Developement Tools (MOT) Updates 

C A the Eclipse Project Updates 


器 @ web Tools Platform (WTP) Updates 
Edit... 


Remove 


A] 11-7 选中 Eclipse Discovery Site 


从 接 下 来 出 现 的 下 载 镜 像 列 表 中 选择 一 个 与 你 的 位 置 合适 的 选 
项 ， 点 击 "OK" 按 钮 (如 果 你 配置 Eclipse 上 自动 选择 下 载 镜像 ， 则 不 会 出 


现 这 一 步 ) 。 这 一 次 你 将 看 到 两 组 插件 : Europa Discovery Site 和 
Hibernate Tools。 再 次 选择 Hibernate Tools 这 组 插件 来 安装 。 和 以 前 一 
样 ， 窗 口 顶 部 还 是 会 出 现 错误 提示 ， 但 是 这 次 我 们 有 机 会 可 以 修复 这 
个 问题 。 一 种 办 法 就 是 选择 整个 "Europa Discovery Site" 插 件 组 ， 但 是 这 
样 的 下 载 量 将 大 大 超过 我 们 实际 的 需要 ， 会 让 Eclipse 的 配置 变 得 过 于 
BERK ° 


所 以 ， 我 们 得 规划 出 需要 从 Europa Discovery Sitet A, Pekka ae) 
的 一 组 插件 。 保 持 Hibernate Tools 插 件 下 点 为 选中 状态 ， 展 开 Europa 
Discovery Site 持 件 组 节点 ， 但 是 不 选中 任何 东西 。 虽 然 可 以 手工 查找 
和 选择 Hibernate Tools 报 告 需要 的 插件 ， 但 这 会 导致 大 量 党 琐 地 摸索 、 
党 试 、 解 决 错 误 ， 才 能 确切 地 明白 哪些 插件 的 组 合 才能 让 我 们 需要 的 
东西 正常 工作 〈 我 们 试验 时 ， 曾 经 找到 过 第 一 个 错误 中 提 及 的 提供 数 
据 工 具 连 接 功能 的 插件 ， 不 过 ， 我 们 发 现 这 个 插件 也 有 它 目 己 要 依赖 
的 其 他 插件 ， 看 来 这 个 插件 还 不 是 我 们 必需 的 惟一 插件 ) 。 就 在 我 们 
摩 拳 探 掌 ， 谁 备 详细 写 写 如 何 精确 选择 需要 下 载 的 插件 时 ， 我 们 注意 
到 界面 右边 的 "Select Required" 按 钮 ， 其 实 可 以 用 它 来 自动 选择 需要 的 
所 有 插件 。 不 过 ， 我 们 的 实验 表明 ， 只 有 当 你 第 一 次 打开 相应 网 站 

(将 从 这 个 网 站 下 载 你 需要 的 插件 ) 旁边 的 “打开 ”三 角形 节点 
时 ，"Select Required" 按 钮 才 会 起 作用 。 直 到 我 们 展开 "Europa Discovery 
site" 这 个 万 点 以 前 ， 它 什么 也 不 会 做 。 在 展开 这 个 万 点 以 后 ， 点 
击 "Select Required" 按 钮 会 自动 选择 解决 依赖 错误 所 需要 的 插件 。 有 既然 


现在 你 已 经 选中 了 Hibernate Tools 节 点 ，Europa Discovery site 节 点 也 展 

开 了 ， 那 就 点 击 一 下 "Select Required" 按 钮 吧 。 最 后 结果 应 该 类 似 于 图 

11-8 所 示 ， 不 过 ， 要 下 载 安装 的 插件 的 确切 个 数 将 依赖 于 原来 你 可 能 
安装 过 的 插件 。 


a M n Updates 
Search Results 
Select features to install from the search result list. 


Select the features to install: 


| Europa Discovery Site 


> 000 Cand C++ Developement 


p O00 Charting and Reporting {More info ) 
pm 000 Communications i ťa 
> 000 Database Development ( Properties ) 
> 000 Enabling Features 

> 000 Graphical Editors and Frameworks kL 
> 000 nip Development 人 Error Details... J 


20 of 119 selected. 
A Show the latest version of a feature only 


OD) Filter features included in other features on the list 


(Finish) 


Al 11-8 ”选中 需要 的 所 有 插件 


这 次 不 会 再 有 任何 错误 消息 妨碍 我 们 安装 Hibernate Tools 了 ! 点 
击 "Next" 按 钮 ， 就 开始 安装 这 组 插件 ， 接 受 在 下 一 个 对 话 框 中 的 许可 协 
议 ， 并 再 次 点 击 "Next"。 之 后 会 再 弹出 一 个 对 话 框 ， 向 你 显示 一 组 可 以 
选择 安装 的 可 选 功能 。 因 为 我 们 只 需要 Hibernate Tools 就 足够 了 ， 所 以 
在 Optional Features (可 选 功能 ) 对 话 框 中 直接 点 击 "Next" 按 钮 以 便 继 
续 安 装 我 们 需要 的 插件 。 默 认 的 安装 位 置 (具体 位 置 随 Eclipse 安 装 位 
置 的 不 同 而 不 同 ) 差不多 总 是 不 错 的 ， 除 非 有 特殊 原因 才 需 要 设置 到 
其 他 位 置 ， 点 击 Installation (安装 ) 对 话 框 的 "Finish" 按 钮 ， 继 续 完 成 插 
件 的 安装 。 


在 下 载 更 新 期 间 ，Update Manager (更 新 管理 器 ) 将 一 直 持 续 运 
行 。 最 后 ， 将 弹出 一 个 Feature Verification (功能 确认 ) 对 话 框 。 对 于 
正在 安装 的 每 个 功能 ， 这 个 对 话 框 将 报告 每 个 功能 是 否 具 有 Eclipse 项 
目 授 权 的 机 构 颁 发 的 加 密 签 名 。 一 些 插件 具有 这 样 的 签名 ， 而 男 一 些 
( 像 Hibernate Tools 本 身 ) 则 没有 有 效 的 签名 。 第 三 方 Eclipse 插件 通常 
都 是 这 样 的 。Eclipse 只 是 对 这 种 情况 进行 警告 ， 希 望 确认 你 愿意 安装 
其 他 网 站 的 插件 。 因 为 我 信任 提供 要 下 载 的 插件 的 网 站 ， 所 以 全 部 都 
确认 继续 安装 。 如 果 你 也 像 我 这 样 (基本 上 ， 如 果 你 想 使 用 Hibernate 
Tools， 就 得 信任 提供 这 些 插件 的 网 站 ) ， 就 只 需要 点 击 "Install" 按 钮 ， 
以 继续 安装 某 个 插件 (如 果 你 不 想 对 每 个 插件 进行 确认 ， 可 以 点 


击 "Install All" 按 钮 ， 以 批量 接受 所 有 插件 ) ° Update Manager (更 新 管 
Dias) 会 继续 安装 。 在 安装 完 所 有 插件 后 ， 它 会 建议 你 重新 启动 
Edlipse。 为 了 确保 安全 ， 点 击 "Yes" 按 钮 ， 等 等 Eclipse 重 新 启动 。 


现在 做 什么 


很 明显 ， 与 过 去 相 比 ，Eclipse 现 在 对 Hibernate 提 供 了 更 多 的 文 持 。 
Hibernate 配 置 文件 的 图 标 现在 包含 了 一 个 小 的 Hibernate 标 志 ， 双 击 这 个 
图 标 或 映射 文件 ， 会 打开 一 个 特殊 的 编辑 器 ， 在 这 个 编辑 器 中 创建 和 
更 新 Hibernate 映 射 文件 会 更 方便 ， 而 不 用 直接 处 理 底层 的 XML (图 11- 
o 


Hibernate Configuration 3.0 XML Editor 


- + Session Factory 


7 CC 
yv Æ Properties 


=> dialect ~ Properties 

— connection.cr name 

= connection.ur dialect 

= connmection.us connection.driver_class 

= connection. connection.ur| 

= connection.sh connection username 

=} connection. connection.password 

=> current sessi connection shutdown 
connection pool size 
current_session_context_class 
cache provider class 
show_sql 


1Y resource=co 


~ Mappings 
8 Caches 


item 
resource=com/oreilly/hh/data/Trs 


图 11-9 Hibernate 配置 文件 编辑 器 


主意 : 这 样 就 不 用 像 在 源 代码 视图 下 ， 得 频繁 查阅 参考 文档 才 可 
以 编辑 了 ! 


SN 


当然 ， 如 果 你 觉得 直接 处 理 XML 更 高 效 ， 可 以 点 击 编辑 器 底部 
的 "Source”( 源 代码 ) 选项 页 ， 仍 然 可 以 查看 XML。 在 源 代码 视图 中 编 
辑 时 ， 你 会 发 现 它 已 经 为 编辑 各 种 Hibernate 相 关 元 素 以 及 取 值 提供 了 
辅助 完成 (completion assistance) 的 功能 ， 如 图 11-10 所 示 。 这 并 不 是 
XML 编 辑 器 普通 的 元 素 名 称 目 动 完成 功能 ， 普 通 目 动 完成 只 是 通过 分 


析 XML DTD 实 现 的 ， 而 DTD 缺 乏 对 属性 名 称 的 足够 描述 ， 只 能 规定 些 
文本 规则 。 


<?xml vwersion='1.8" encoding="utf-8'?> 
<IDOCTYPE hibernote-configuration PUBLIC 
".//Hibernate/Hibernate Configuration DTD 3.8//EN" 
"http: //hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 
<session-factory> 


<l=-- SQL dialect --> 
<property name=j"d">org.hibernate.dialect .MySQLSDialect</property> 
default -batch fetch size 


<l-- Database con default catalog 


<property name="d | 
<property default_entity_mode 


name="connect default_schema 
<property nome="c dialect 
<property name="¢ k 
<property nome="¢ 


| property> 


roperty> 


<!-- JDBC connect 
<property name="¢ 


图 11-10 ” ”Hibernate 配置 文件 编辑 器 中 的 属性 名 称 上 自动 完成 功能 


你 可 以 使 用 普通 的 Eclipse 自 动 完 成 组 合 键 (ControlSpace) 来 打开 
相应 的 弹出 窗口 。 


映射 文档 编辑 器 如 图 11-11 所 示 。 这 两 个 编辑 器 看 起 来 功能 强大 也 
很 有 用 ; 值得 花 些 时 间 来 搞 明 白 它们 的 工作 原理 和 功能 。 对 于 在 
Eclipse 中 使 用 Hibermmate 来 说 ， 它 们 本 和 号 也 是 很 有 价值 的 工具 。 


Hibernate 3.0 XML Editor 


= Track.hbm 


F oo) Trackhbmxml* 
y @ Classes 
> © comoreilly 
y @ Queries 
? com.oreilly.hh 
? com.oreilly.hh name 


title 
y ? comoreilly.hh 
ly filePath 
Ə track 


playTime 
artists 
added 
volume 
sourceMedia 
comments 


+ Properties 


+ Subclasses 


subclass info 


图 11-11 Hibernate 映射 编辑 器 


为 了 探索 用 Hibernate Tools 还 可 以 做 些 什 么 其 他 事 ， 首 先 要 在 项 目 
中 激活 它 。 如 果 你 是 从 一 个 新 项 目 开始 的 ， 可 以 选择 先 创 建 一 个 新 的 
Hibernate 配 置 文件 。 如 果 你 是 从 一 个 现 有 的 Hibernate 项 目 开 始 的 本章 
我 们 就 是 这 样 做 的 ) ， 你 可 以 跳 过 这 一 步 ， 只 需要 创建 一 个 新 的 
Hibernate 控 制 台 (console) 就 可 以 了 。 


[1] http://www.oreillynet.com/onjava/blog/2004/06/ive_been_eclipsed.html. 


创建 一 个 Hibernate 控 制 台 配置 


在 项 目 浏览 器 中 选择 项 目 ， 选 择 File -> New 一 Other， 扩 展 由 工具 添 
加 的 Hibernate 节 点 (如 图 11-12) ， 选 择 Hibernate Console Configuration 
(从 这 里 能 够 选择 创建 一 个 新 的 配置 文件 、XML 映 射 文件 以 及 对 配置 
文件 进行 逆向 工程 处 理 (本 书 不 介绍 这 个 主题 ) ) 。 点 击 "Next" 以 继续 
为 项 目 安装 这 一 工具 。 


TER: 如 果 你 仍然 还 在 使 用 旧 的 properties 属 性 文件 来 配置 
Hibernate， 则 可 以 使 用 这 个 例子 上 面 的 "Property file" ° 


Select a wizard 
Creates a new Hibernate Console Configuration 


> > General 
b i= CVS 
Y & Hibernate 
© Hibernate Configuration File (cfg.xml) 


© Hibernate Console Configuration 
" Hibernate Reverse Engineering File (reveng.xml) 
® Hibernate XML Mapping file (hbm.xml) 

> (> Java 

> 区 Mylyn 


" 


4 


图 11-12 Hibernate Tools 提 供 的 新 的 Eclipse 向 导 


Hibernate Console Configuration OHF AE (如 图 11-13 所 示 ) ， 
先 要 通过 点 击 相应 的 "Browse" (浏览 ) 按钮 ， 再 在 项 目 中 选 定 一 个 文 
件 ， 告 诉 工具 到 哪儿 可 以 找到 你 的 Hibernate 配 置 文件 ( 当 第 一 次 使 用 
配置 文件 向 导 来 创建 配置 文件 时 ， 会 自动 创建 好 配置 文件 ， 最 新 版 本 


的 Hibernate Tools 工 具 看 起 来 足够 智能 ， 可 以 上 自己 在 本 书 代码 示例 的 目 
录 结 构 中 找到 配置 文件 ) 。 


eoe 


Create Hibernate Console Configuration 


| This wizard allows you to create a configuration for Hibernate a’ 


Console. 


Classpath Mappings 


‘Hibernate ch 11 


Hibernate ch 11 


( Core C) Annotations (jdk 1.5+) (C) JPA (idk 1.5+) 


mm TI 


Configuration file: /Hibernate ch L1/sre/hibernate.cfg.xmi ( Browse... 


A 


图 11-13 建立 Hibernate Console 配 置 


对 于 大 部 分 项 目 来 说 ， 这 个 选项 卡 (tab) 中 的 其 他 设置 可 以 不 用 
修改 ， 不 过 ， 因 为 我 们 使 用 Maven Tasks for Ant 来 管理 我 们 的 依赖 库 ， 
而 Hibernate 不 会 奇迹 般 地 知道 到 哪 可 以 找到 Maven 仓 库 中 的 数据 库 驱 动 
程序 ， 所 以 需要 调整 类 路 径 (Classpath) 的 设置 。 点 击 "Classpath" 选 项 
卡 ， 在 这 个 选项 卡 上 再 点 击 "Add External JARS" 按 钮 ， 手 工 告诉 工具 到 
哪 找 数据 库 驱 动 程序 ， 如 图 11-14 所 示 。 


eoo 


Create Hibernate Console Configuration F 
This wizard allows you to create a configuration for Hibernate -e 


Console. 


C m | 
General 一 Classpath 一 Mappings | 


Additional classpath (Hibernate jars not necessary!) 


Add JAR/Dir... 
( Add External JARS... ù 


( Remove } 


图 11-14 Hibernate Console 类 路 径 配 置 


注意 : 可 以 按 共享 模式 (shared mode) 来 使 用 HSQLDB， 提 供 多 
个 数据 库 连 接 ， 不 过 这 部 分 不 在 本 书 讨 论 范围 内 ， 而 且 你 还 需要 考虑 
在 哪 以 及 如 何 运行 “服务 絮 *JVM 。 


在 打开 的 文件 选择 对 话 框 中 ， 导 航 到 Maven 仓 库 的 目录 (可 以 参阅 
第 1 章 1.7 节 结尾 部 分 的 介绍 ) ， 找 到 MySQL 驱 动 程序 。 在 这 个 例子 
中 ， 如 果 是 在 Mac OS X 操 作 系 统 下 ， 驱 动 程序 应 该 位 于 
~/.m2/repository/mysql/mysql-connector-java/5.0.5/mysql-connector-java- 
5.0.5.jar。 在 上 一 章 的 基础 上 ， 我 们 继续 使 用 MySQL。 用 Hibernate 
Tools 连 接 外 部 数据 库 要 方便 得 多 ， 这 时 再 像 我 们 原来 那样 ， 试 图 使 用 
敬 入 在 内 存 中 的 数据 库 ， 就 不 是 个 好 想法 了 ， 因 为 Hibernate Tools 会 认 


为 它们 可 以 和 目 由 地 将 到 数据 库 的 连接 保持 为 打开 状态 ， 这 样 ， 当 你 想 
对 数据 库 进行 其 他 操作 ， 比 如 通过 Ant 来 运行 db 构建 任务 来 查看 数据 库 
的 内 容 时 ， 束 不 得 不 先 退 出 Edlipse。 相 反 ， 像 MySQL 这 样 独立 的 数据 
库 ， 在 处 理 多 个 同时 并 发 的 数据 库 连 接 时 ， 就 没有 这 样 的 问题 。 


选择 好 驱动 程序 的 JAR 文 件 以 后 ， 点 击 "Open" 按 钮 (如 图 11-15 所 


(Q search 


JAR 


oh Applications 
fy Documents 
Name mysql- 

2 Movies connector- 

§ Music java-5.0.5. | | 
à r 
fy Pictures a 

@ Favorites Size 504 KB 

S bin Kind jar I 


图 11-15 为 Hibernate Console 配 置 加 载 数 据 库 驱 动 程序 JAR 文 件 


注意 : 如 果 你 在 使 用 像 Oracle 这 样 版 权 专 有 的 数据 库 ， 可 能 就 需要 
自己 手工 下 载 JDBC 驱 动 程序 了 。Maven 仓 库 只 提供 自由 软件 。 


在 配置 好 类 路 径 以 后 〈 如 图 11-16 所 示 ) ， 就 可 以 点 击 "Finish" 按 
钮 ， 准 备 创建 我 们 的 Hibernate Console 配 置 。 


808 
Create Hibernate Console Configuration 


This wizard allows you to create a configuration for Hibernate 
Console. 


Additional class | (Hibernate not nece 


图 11-16 Hibernate Console 类 路 径 配 置 完毕 


Hibernate Tools 会 询问 我 们 是 否 想 为 项 目 添 加 对 Hibernate 的 支持 
(如 图 11-17 所 示 ) 。 好 哇 ， 那 就 是 我 们 盼望 的 啊 ! 马上 点 击 "OK" 按 
FH ° 


e 0o 


1 The project named ‘Hibernate ch 11' does not have Hibernate features enabled. 
/ Should it be updated to use Hibernate ch 117 


Enable Hibernate features for project 


CD Eee 


图 11-17 Hibernate 功能 准备 好 了 


更 多 的 编辑 文 持 


我 们 的 项 目 现在 已 经 支持 Hibernate Tools 了 ， 那 可 以 用 它 做 什么 
We? 咽 ， 现 在 ， 当 你 编辑 映射 文件 时 ，XML 编 辑 器 就 能 够 帮 你 自动 完 
成 数据 表 和 列 的 名 称 (如 图 11-18 所 示 ) 。 这 也 正 是 为 什么 需要 将 项 目 
关联 到 Hibernate Console 配 置 的 原因 : Hibernate Tools 实 际 上 维护 着 一 个 
Hibernate 会 话 ， 通 过 它 来 检查 数据 库 模 式 ， 为 实际 项 目 环境 提供 相关 
的 帮助 。 


<hibernate-mapping> 


<class name="com.oreilly.hh.data. Track" table="track"> 
<méta attribute="class-description"> 
Represents a single playable track in the music database. 
@author Jim Elliott (with help from Hibernate) 
</meta> 


<id name="id" type="int" columnm="TRACK_ID"> 
<meta attribute-"scope-set ">protected</meta> 
<generator class="native"/> 

</id> 


<property namee"title” typee"string"> 
<meta attributee"use-in-tostring">true</meta> 
<column name="" not-nulle"true" index="TRACK_TITLE"/> 


</property> TRACK_ID 


<property name=" 


TITLE 
flep 
= playTime 
<meta attribut added 
</property> VOL_LEFT 
- VOL_RIGHT 


<property name= 


图 11-18 在 Hibermnate 了 映射 编辑 器 中 目 动 完成 列 名 的 输入 


我 们 已 经 演示 了 TRACK 表 的 列 名 的 自动 完成 ， 不 过 也 可 以 自动 完 
MRA 〈 在 class 定 义 ， 以 及 关联 定义 中 的 设置 ) 。 如 果 已 经 创建 好 了 
组 成 模型 的 Java 对 象 ， 这 时 Java 对 象 的 属性 名 和 类 名 的 输入 也 会 具有 自 
动 完成 帮助 ， 以 及 JavaDoc 支 持 (如 图 11-19 所 示 ) 。 属 性 类 型 的 自动 完 
成 也 总 是 可 用 的 ， 不 过 ， 在 非 源 代码 视图 中 通过 下 拉 菜 单 来 选择 ， 是 
更 简单 的 办 法 。 


<property nome="added" type="dote"> re 
«meta attribute="Field-description">When the track wos cred 
</property> | 


<property name="volume" type="com.oreilly.hh.StereoVolumeType a | 
<meta attribut a added Date - Track | | How loud to play the track 
ee ottribud artists Set<com.oreilly.hh.dataArtist= - Track 
4Co lumn nomte 
zeit an cine comments Setcjavalang String> = Track 
</property> filePath String - Track 
id int = Track 
emeta attribut o sourceMedia SourceMedia - Track 
tithe String- Track 
volume een * 


<meta attribut 
</property> 


i] 
o 
a 
5 
<property name=" o playTime Date - Track 
oa 
oS 
D 


<set name=" comme 
<key ¢olumn=" 
<element cold 
af Set» 


图 11-19 Hibernate 映射 编辑 器 中 属性 名 称 的 目 动 完成 


对 于 数据 库 驱 动 的 自动 完成 ， 我 们 确实 遇 到 了 一 个 “ 意 想 不 到 的 碎 
fil” (gotcha) 。 即 便 SQL 通 常 是 不 区 分 数据 表 和 字段 名 称 的 大 小 写 ， 
而 Hibernate 需 要 区 分 。 我 们 的 曲目 数据 表 全 是 用 小 写字 母 创建 的 ， 而 
映射 文档 都 是 用 大 写字 母 引 用 的 ， 如 采 不 注意 到 这 一 点 ， 就 不 能 正常 
使 用 上 自动 完成 。 修 改 映射 文档 ， 让 它 与 数据 库 模式 定义 中 真实 的 大 小 
写 情况 相 匹 配 ， 束 可 以 解决 问题 了 。 


里 还 可 以 使 用 Eclipse 的 男 一 个 有 用 功能 ，F3 快 捷 键 ， 它 用 于 导 
航 跳 转 到 变量 、 方 法 以 及 类 的 声明 位 置 ， 在 映射 编辑 器 中 使 用 这 个 快 
捷 键 可 以 把 你 带 到 正在 映 冉 到 的 类 或 属性 的 Java 代 码 定义 中 。 


我 们 惊喜 地 发 现 ， 


编辑 右 还 文 持 日 定义 的 类 型 映 册 ， 如 图 11-20 中 


类 型 自动 完成 菜单 的 底部 所 示 ， 看 起 来 与 GUI 映 射 编辑 器 有 些 不 同 。 


serializable 
short 
string 

text 

time 
timestamp 
timezone 
true_false 
yes_no 


com.oreilly.hh.SourceMediaType à | 
com.oreilly. hh. StereoVolumeType k ha 


图 11-20 BENKEI H Isc aM 


稍 等 ， 还 有 更 多 


这 些 只 是 Edlipse 的 普通 功能 ， 在 Java 视 图 下 就 可 以 使 用 。 不 过 ,在 
打开 Hibernate Console 视 图 后 ， 还 有 更 多 其 他 宅 门 可 以 应 用 。 要 打开 这 
个 视图 ， 可 以 点 击 工具 条 上 的 "Open Perspective" 按 钮 ， 再 选 


择 "Other" (其 他 ) 3 


选项 ， 或 者 选择 Window > Open Perspective > Other ° 


这 两 种 方法 都 会 打开 "Open Perspective" 对 话 框 ， 如 图 11-21 所 示 。 选 


择 "Hibernate Console"， 再 点 击 "OK" 按 钮 。 


= CVS Repository Exploring 


& java (default) 

Gd Java Browsing 

fe! Java Type Hierarchy 
@ Planning 


4 Plug-in Development 
Font Resource 
=o Team Synchronizing 


图 11-21 打开 Hibernate Console 视 图 


Hibernate Console 视 


首先 要 注意 的 是 图 11-22 所 示 的 Hibernate Configurations (Hibernate 
配置 ) 视图 。 图 中 ， 我 们 已 经 展开 了 本 市 开始 创建 的 "Hibernate ch 
11" 配 置 节 点 ， 看 看 怎么 使 用 其 中 的 映射 、 类 、 数 据 库 模式 等 条 目 。 注 
意图 中 为 主键 (identifier) 、 多 对 一 、 一 对 多 关联 分 配 的 标识 图 标 。 在 
这 个 视图 中 提供 了 丰富 的 有 用 信息 。 打 开 这 个 视图 的 下 拉 沫 单 ， 可 以 
看 到 通过 它 可 以 访问 儿 个 有 趣 的 功能 〈 同 时 也 解释 了 沫 单 左边 各 按钮 
的 功能 目的 ) 。 


H Track.hbm.xmi 
大 HQL Editor 


上 Trackhbmxml £3 ~“ 四 Track.java | 


jee" date™> 


下 ry Hibernate ch 11 


v [Ñ Configuration oi Hibernate Criteria Editor 
¥ © album 
" 
bE d id:int E Add Configuration... error 
Si 
> © title: string Rebuild configuration ostring"> 
> © munbiecs:: nteger Edit Configuration 
Bb & artists : Set<Artist> Delete Configuration {> 
> & comments : Set<string> 
be & tracks : List <AlbumTrack> Refresh i = 
= {C 
P © added : date Run SchemaExport Be wh 
> O artist tostring"> 
> O Track </property> 
b "Wi Session Factory 
到 国 Database ¿set name=" COmments" table=" TRACK_CO 


<key column-"TRACK_ID"/> 
<element column="COMMENT” type="s 
¿laet 


¥ 39 notebook db 
b E ALBUM_ARTISTS 
> 国 ALBUM_COMMENTS 
> E] ALBUM_TRACKS 
y E ARTIST 
> Ë ARTISTID: INTEGER 
目 NAME: VARCHAR 


E actualArtist : INTEGER 
Snes 


class> 
very nome="com.oreilly.hh.tracksNoLe 


<] CCOATAC 
select track.id, track.title Fro 


Tree Source 


图 11-22 Hibernate Console 视 图 下 的 Hibernate 配 置 界面 


以 简单 的 方式 ， 这 一 菜单 可 以 让 我 们 编辑 现 有 的 Hibernate 配 置 、 
为 其 他 Hibernate 项 目 创建 新 的 配置 ， 如 果 在 Eclipse 环境 以 外 修改 了 某 些 
文件 ， 还 可 以 刷新 这 一 视图 。 更 为 强大 的 是 ，"Run Schema Export" I 
可 以 让 我 们 只 要 简单 地 选中 某 个 配置 项 ， 再 运行 这 个 染 单 选项 ， 束 可 
以 得 到 与 第 2 章 编写 的 schema Ant 构 建 任务 同样 的 结 


一 荣 单 为 它 左边 那 些 看 起 来 很 神秘 的 按钮 的 作用 提供 了 些 提示 
说 明 。 接 下 来 我 们 看 看 这 些 按钮 可 以 完成 什么 复杂 功能 ， 首 先 从 "HQL 


Editor" 开 始 ， 图 11-23 演 示 了 选择 菜单 项 并 点 击 按钮 后 ， 将 会 显示 的 界 
面 。 看 起 来 我 们 应 该 能 够 在 这 个 地 方 处 理 HQL， 但 是 使 用 Control Space 
组 合 键 试图 自动 输入 表格 名 称 时 ， 会 产生 错误 消息 "Configuration not 

available nor open”( 配 置 不 可 用 或 打 不 开 ) 。 不 过 ， 我 认为 这 里 

用 "or" 更 合适 些 ， 看 起 来 需要 将 这 个 窗口 和 某 个 Hibernate Console 配 置 
关联 起 来 。 行 ， 这 就 够 了 ， 虽 然 在 Mac OS X 下 界面 有 些 不 清楚 ， 不 过 
顶部 的 染 单 似乎 就 是 个 用 来 解决 问题 的 好 办 法 。 


[X] Track. hbmxml 


> w | bax results: Tal 
from Al 


J 


Al 11-23 一 个 空白 的 、 未 经 配置 的 HQL Editor 视 图 


确实 如 此 ， 配 置 沫 单 束 在 这 里 。 在 选择 了 沫 单 中 的 Hibernate ch 11 
配置 项 以 后 ， 就 激活 了 编辑 器 的 独特 功能 和 目 动 完成 的 功能 “如 图 11- 
24 所 示 ) 。 看 起 来 可 以 将 命名 查询 集中 在 一 起 ， 再 粘贴 到 映射 文档 
P, E? 我 们 看 看 它 还 能 做 些 什 么 事情 。 


[È Track.hbm.xml 


> | Hibernat... a | ax results: | 


from Al 
O Album - com.oreilly.hh.data 


© Artist- comoreilly.hh-datay 


图 11-24 在 连接 到 某 个 Hibernate Console 配 置 以 后 的 HQL Editor 界 面 


， 如 采 你 也 同样 得 到 关于 配置 不 可 用 的 错误 消 


在 选择 菜单 项 后 
a 不 没有 为 它 打开 一 个 SessionFactory ° 


息 ， 这 可 能 意味 着 Hibernate Toolsi® 


你 可 以 用 鼠标 右键 点 击 Hibernate Configurations 视 图 中 的 配置 ， 再 选 
(如 图 11-25 所 示 ) 。 其 他 一 些 操 作 ， 比 


择 "Create SessionFactory" 选 项 
如 向 下 深入 (drilling) Configurations ` Session Factory 以 及 Database 树 


忆 点 的 细节 ， 似 乎 也 需要 一 定 的 窍门 。 


JC ee eree ] ġir Sle Oe oe 


— SanrionFuctory 
HAL Editor s 
Wi Hibernate Criteria Editor 


> ©! Database 


© Add Configuration... 
Edit Configuration 
Delete Configuration 


Refresh 
Run SchemaExport 


图 11-25 显 式 打开 配置 的 SessionFactory 


自动 完成 帮助 对 于 编写 查询 确实 有 用 ( 它 可 以 完成 属性 名 称 、 
HQL 关 键 字 、 画 数 名 称 等 内 容 的 辅助 输入 ) ， 不 过 这 个 工具 真正 强大 
的 功能 还 要 数 它 可 以 让 你 运行 查询 并 查看 结果 ， 可 以 方便 地 验证 查询 
和 数据 是 否 正 确 ， 或 者 只 是 为 了 更 多 地 了 解 HQL 和 数据 模型 。 点 击 编 
辑 器 左边 顶部 的 较 大 的 那个 绿色 "Run HQL" 按 钮 ， 就 可 以 运行 HQL， 并 
立即 显示 运行 结果 ， 如 图 11-26 所 示 。 


E Track.hbm.xml | we “Hibernate ch 11 BN, ml 


ie | Hibernat... re I Tel 


from Artist 


©) Error Log i Sa" Hibernate Dynamic SQL Preview| 园 Console] 


com.oreilly.hh.data_Artist 

com.oreilly.hh.data.Artist@989cac [name="PPK' actualArtist="null’ | 
com.oreilly.hh.data. Artist@5615d9 [name= The Buggles' actualArtist="null' ] 
com.oreilly.hh.data.Artist@b498d1 [name='Laurie Anderson’ actualArtist='null’ ] 
com.oreilly.hh.data.Artisw@9ceabe [name="William Orbit’ actualArtist="null’ ] 
com.oreilly.hh.data.Artist@fé6def4 [name='Ferry Corsten’ actualArtist='null' | 
com.oreilly.hh.data.Artist@2436f4 [name="Samuel Barber’ actualArtist='null’ | 
com.oreilly.hh.data.Artist@264374 [name= ATS actualArtist="null’ ] 
com.oreilly.hh.data.Artist@2424eb [name="Pulp Victim’ actualArtist="null' | 


from Artist 53 


图 11-26 通过 Run HQL 按 钮 运行 HQL， 并 查看 结 


来 吧 ， 壬 试 一 组 。 添 加 一 些 投影 、 排 序 以 及 只 合 函数 ， 这 真是 个 
好 机 会 ， 可 以 真正 实践 一 下 第 9 章 提 到 的 那些 查询 功能 ! 但 是 ， 在 进入 
下 一 种 编辑 需 以 前， 还 有 一 两 个 穹 门 .…… 


如 有 果 你 对 大 规模 的 数据 库 表 执行 查询 ， 可 能 希望 对 结果 返回 的 最 
多 记录 数量 设置 一 定 的 限制 ， 这 时 就 可 以 使 用 编辑 顺 顶 部 的 第 2 个 沫 
单 。 已 经 将 数据 加 载 到 了 内 存 中 ， 如 果 没 有 的 话 ，Eclipse 则 可 能 会 有 


RIER o 当然， 我 们 这 本 书 中 小 儿科 似 的 例子 肯定 不 会 有 任何 问 


题 。 


到 目前 为 上 ，Hibernate Configurations 视 图 下 面 的 Properties ( 属 
性 ) 视图 的 表现 一 般 ， 当 我 们 正在 编辑 映射 文件 时 ， 它 用 于 显示 XML 
元 素 属 性 之 类 的 东西 ， 你 以 前 在 Eclipse 中 可 能 见 过 这 些 。 点 击 Hibernate 
Query Result (Hibernate 查 询 结 果 ) 视图 中 的 一 行 ， 再 看 看 会 发 生 什 
么 。 图 11-27 是 点 击 Artist 查 询 结 果 中 的 William Orbit 一 行 时 的 结果 。 


注意 : 多 么 可 怕 的 原型 、 浏 览 、 学 习 以 及 调试 工具 |! 


你 可 以 查看 选中 结果 对 象 的 所 有 Hibernate 属 性 ， 通 过 展开 相应 的 
三 角形 图 标 可 以 深入 查看 该 对 象 的 关联 和 集合 。 再 一 次 ， 你 应 该 自己 
演 斌 一 下 这 些 功 能 。 (我 们 可 能 不 用 对 此 再 提 什 么 建议 了 .….…) 


¥ Identifier 

id 
wy Properties 

actualArtist 

name 

Y tracks 

y #0 
added 
artists 
comments 
filePath 
id 
playTime 
sourceMedia 
title 
volume 


> 


William Orbit 


2007-09-24 


vol2/album972/track02.mp3 | 
5 
00:07:39 
CD 
Adagio for Strings (ATB Remix) 
Volume[left= 100, right=100) 


图 11-27 在 Properties 视 图 中 浏览 查询 结 


你 可 能 会 问 HQL 编 辑 器 右边 的 Query Parameters (查询 参数 ) 视图 
是 做 什么 用 的 (如果 没 这 样 的 问题 ， 也 可 能 是 因为 还 没有 显示 这 


R, 


文 个 窗口 ) 。 这 


文 个 视 
择 Window > Show View > Other 菜单 ， 再 从 弹出 对 话 框 的 


Hibernate 部 分 选择 Query Parameters， 就 可 以 打开 这 个 窗 


口 是 用 于 处 理 查询 中 包含 的 命名 参数 的 。 图 11-28 显 示 了 一 个 例子 ,我 
们 从 第 3 章 粘 贴 了 一 个 tracksNoLongerThan 命 名 查询 ， 接 着 发 现 点 击 
Query Parameters 窗 口中 的 ":P+" 按 钮 ， 就 可 以 生成 查询 中 要 用 到 的 一 个 
参数 列表 (这 个 例子 只 有 一 个 参数 ) 。 我 们 必须 将 参数 的 Type 设 置 为 
time (通过 下 拉 列 表 选 择 ) ， 按 照 窗 口 列表 下 面 提示 的 格式 帮助 信息 ， 
在 Value 列 中 输入 一 个 时 间 值 ， 再 点 击 查 询 编辑 器 顶部 左边 的 带 有 绿色 
箭头 的 "Run" 《运行 ) 按钮 ， 就 可 以 在 底部 的 Hibernate Query Result 窗 
口中 看 到 希望 的 查询 结果 了 。 


[R] Trackhbmxml | if "Hibernate ch 11 oN = D |:p query Parameters a Outline | =n 
s : | PHH)? 
> Hibernat.. EA Max results: Tl he P 总 
Select teack.id, track.title from Track as track || Name Type Vabue null? 
where track.ployTime <= : length length tirne 0-05 0 [ 
order by trock.title desc 


I 


| 3 
|| Format: 00:56:17 


CJ Error Log Ep Hibernate Dynamic SOL Preview) E console! xo 
ü 1 

2 Video Killed the Radio Star 

F Test Tone L 

L Russian Trance 


select wackid, rackeite from Track ag ack where trackplayTime <= dengih order by wacksite dese B A 


图 11-28 在 Query Parameters 窗 口中 设置 命名 参数 


很 难 再 想像 出 一 个 比 这 更 简单 的 界面 来 试验 HQL 查 询 了 ! HQLE 
询 触 发 的 核心 SQL 语 句 可 以 在 下 面 这 个 窗口 中 查看 : Hibernate Dynamic 
SQL Preview (Hibernate) SQL) ， 在 图 11-28 中 它 紧 挨 着 查询 结 


果 选 项 页 ， 如 果 你 在 自己 的 Eclipse 中 看 不 到 这 个 窗口 ， 可 以 通过 选择 
Window > Show View > Other 荣 单 ， 再 从 弹出 对 话 框 的 Hibernate 部 分 选 
择 Hibernate Dynamic SQL Preview， 束 可 以 打开 这 个 窗口 。 在 这 个 窗口 
中 看 到 的 SQL， 就 是 我 们 在 查询 编辑 絮 中 输入 的 HQL 在 执行 时 使 用 的 
实际 的 SQL 语 句 ， 如 图 11-29 所 示 。 


©) Error Log | 5 Hibernate Query Result | 和 Hibernate Dynamic SQL Preview gN 8 Console) 一 日 


Or integer, sering 


select 
wackO_.TRACK_ID as col_O_0_, 
twackO_.TITLE as col_1_0_ 
from 
track trackO_ 
where 
trac kO_.playTime< =? 
order by 
trackO_.TITLE desc 


o E 


图 11-29 Dynamic SQL Preview O 


这 个 窗口 的 内 容 非常 有 趣 ， 因 为 它 是 真正 动态 的 ， 正 如 其 窗口 标 
题 所 示 。 如 果 在 HQL 编 辑 器 中 编辑 查询 的 同时 ， 保 持 打 开 这 个 窗口 ， 
束 可 以 看 到 你 正在 输入 的 HQL 语 句 所 对 应 的 SQL 语句 ， 这 样 的 效果 相 
当 直 观 。 例 如 ， 考 虑 如 图 11-30 所 示 的 非常 简单 而 且 上 自然 的 HQL 查 询 ， 
以 及 该 HQL 生 成 的 SQL 语句 。 


5 Trackhbmxml 


| > | | Hibernat.. a | |Max results: 


from Artist 
where tracks.size > ij f 


9) Error Log Hibernate Query Result | S> Hibernate Dynamic SQL Preview #3 \_B Console) 


0; com.oreilly hh.dataArtist 


| 6 
select 
artist0_ARTIST_ID as ARTISTL_?_, 
artistů. NAME as NA 
artisto_ actualArtist as actualAr3_ ra 
y-a artistO_ 
where 
‘wale 
countttracks 1_.ARTIST_ID) 
TRAC K_ARTISTS tracks 1_ 
artist0_ARTIST.\Detracks1_ARTIST_{O 
)>1 
图 11-30 同时 查看 简洁 的 HQL 与 完整 的 SQL 
殉 像 我 们 的 一 位 技术 编辑 指出 的 ， 这 是 在 对 SQL 不 十 分 了 解 的 Java 
开发 人 员 和 对 HQL 或 JDBC 不 感 兴趣 的 DBA 之 间 进 行 交 流 的 非常 有 价值 
的 工具 。 
最 后 ，Criteria Editor (条件 查 询 编辑 器 ) 窗口 ， 可 以 通过 最 后 一 个 
还 没有 介绍 过 


半 的 按钮 访问 ， 如 图 11-31 所 示 ， 它 的 作用 应 该 可 以 通 
名 称 猿 得 出 来 。 它 可 以 让 你 生成 Criteria 查 询 的 原型 ， 提 供 Java 代 码 的 自 
动 完成 (以 及 预定 义 的 会 


话 变 量 ， 以 作为 供 查询 使 用 的 Hibernate 
Console 配 置 的 会 话 ) 。 


ER =B)(pat 


> Ceme | Max resus: [iam 
Criteria criteria = session. cresteCriterialTrack, class); | 
criteria.add(Restrictions. Ifke("title", "w", MatchMode. ANYWHERE) 
-ignoreCase()); le(String propertyName, Object value) SimpleExpres 
Ci leProperty(String propertyName, String otherPropert 
© like(String propertyName, Object value) SimpleEx | 
m like{Stfing propertyName, String value, MatchMode m 
F It(String propertyName, Object value) SimpleExpres 
o hProperty(String propertyName, String otherPropert | 


E Hibernate Query Rest 
ae Aoo 
| eno info> 

com.oreilly.hh.data.Track@e69O0cf [title="Video Killed the Radio Star’ volume="Volume[left=100, right=1 


com.oreilly.hh.data.Track@2d27d6 [tithe="Gravity’s Angel’ volume="Volume[left= 100, right= 100)" sourc 


A] 11-31 Hibernate Tools 的 Criteria Editor 


如 果 你 发 现 目 动 完成 功能 不 能 使 用 ， 记 得 检查 Run 按 钮 旁边 的 沫 单 
中 是 否 选 择 了 有 效 的 Hibernate Console 配 置 ， 就 像 HQL Editor 的 使 用 一 
样 。 同 时 ， 也 要 确保 Eclipse 认为 Criteria Editor 窗 口 处 于 选中 状态 (其 边 
框 为 蓝 色 ) 。 有 时 我 正 准备 要 在 Criteria Editor 窗 口中 输入 些 东 西 时 ， 而 
查询 结果 窗口 的 边框 却 是 蓝 色 的 ， 所 以 本 来 可 以 目 动 完成 或 编辑 的 键 
生命 令 都 无 法 正常 使 用 。 


其 他 


代码 生成 功能 ?这 些 也 可 以 用 ， 只 是 我 们 在 前 面 还 没有 直接 关注 
它们 。 在 为 特定 的 项 目 添 加 工具 支持 以 前 ， 它 们 束 已 经 可 以 使 用 ,不 
过 在 我 们 至 少 创建 一 个 Hibernate Console 配 置 以 前 ， 它 们 并 不 会 做 些 什 
AS A 就 会 发 现 Hibernate Tools 还 提供 了 一 个 
新 的 菜单 选项 (如 图 11-32 所 示 ) ° 


一 


Jri Halt O- |W 二 者 Gr lm oe 1d bie te Ore 

?, Run As > 
Q, Open Hibernate Code Generation Dialog... 
Organize Favorites... 


| EclipsejUnit 
¥ |= Hibernate ch 11 
= g sre 


<hibernate-mapping> 


图 11-32 Hibernate Tools 提 供 的 代码 生成 菜单 


这 个 新 集 单 隐藏 得 很 隐蔽 ， 需 要 费 些 时 间 才能 看 到 它 。 这 个 沫 单 
是 访问 Hibernate Tools 用 来 建立 和 运行 代码 生成 功能 的 图 形 界面 的 门 
Pax 


代码 生成 


让 我 们 看 看 如 何 用 Hibernate Tools 实 现 原 来 在 第 2 章 中 创建 的 
codegen Ant 构 建 目 标 完成 的 功能 。 为 了 避免 翻 书 查 找 例 子 的 麻烦 ， 重 
新 在 例 11-1 中 列 出 该 构建 目标 的 内 容 。 


例 11-1: 重 温 代 码 生 成 的 Ant 构 建 任务 


<! --Generate the java code for all mapping files in our source 
tree--> 

<target name="codegen"depends="usertypes" 

description="Generate Java source from the O/R mapping files"> 

<hibernatetool destdir="${source.root}"> 

<configuration 
configurationfile="${source.root}/hibernate.cfg.xml"/> 

<hbm2java jdk5="true"/> 

</hibernatetool > 

</target> 


为 了 在 Eclipse 中 重新 实现 这 一 功能 ， 我 们 先 从 图 11-32 所 示 的 荣 单 
中 选择 Open Hibernate Code Generation 对 话 框 。 和 窗口 界 面 如 图 11-33 所 


示 ， 像 其 他 Eclipse 工具 一 样 ， 这 个 对 话 框 也 提供 了 让 你 选择 命名 配置 
的 方法 。 


凑合 六 Hibernate Code Generation... 


| Create, manage, and run configurations 
Select or configure a code generation 


a1 
x |B Configure launch semings from this dialog: 
a) [全 = Press the 'New button to create a configuration of the selected type. 


type filter text 
Qy Hibernate Code Generation I = Press the ‘Duplicate’ button to copy the selected configuration. 


| k = Press the ‘Delete button to remove the selected configuration. 
> = Press the ‘Filter’ button to configure filtering options. 
= Edit or view an existing configuration by selecting it. 


Configure launch perspective settings from the Perspectives preference page. 


Filter matched 1 of 1 items 


图 11-33 准备 创建 一 个 新 的 Hibernate 代 码 生 成 配置 


看 起 来 为 了 激活 创建 新 配置 的 功能 ， 在 点 击 "New" 按 钮 以 前 需要 先 


‘iti "Hibernate Code Generation" 选 项 卡 。 


在 激活 创建 新 配置 的 功能 后 ， 束 可 以 点 击 "New" 按 钮 (这 个 按钮 的 
图 标 是 一 个 页 面 标志 ， 在 页 面 的 右上 角 有 个 加 号 ) 来 建立 一 个 配置 ， 
以 生成 我 们 的 数据 对 象 。 它 会 打开 一 个 配置 窗口 ， 上 面 有 很 多 选项 ， 
其 中 的 一 些 选 项 如 图 11-34 所 示 。 


890 Hibernate Code Generation... 


| Create, manage, and run configurations 
| & Console configuration muse be specified 


[mx |B Be ， 
Name: New configuration 


| type filter text 


7 EN Hibernate Code Generation 


Gh Mew configuration | | Console configuration: 一 一 一 一 一 一 
k | 


Output director 


图 11-34 创建 一 个 Hibernate 代 码 生 成 配置 


注意 : 当然 ， 如 果 你 在 Eclipse 工作 空间 中 打开 多 个 项 目 ， 在 这 个 
浏览 对 话 框 中 束 可 以 看 到 更 多 的 选择 根 节 点 。 


我 们 将 新 的 配置 命名 为 "Generate Ch 11 Model", i4#Hibernate 
Console 配 置 ， 浏 览 打开 项 目的 src 目 录 (如 图 11-35 所 示 ) ， 最 终 对 话 框 
的 Main 选 项 页 界面 应 该 如 图 11-36 所 示 。 


> Hibernate ch 11 
> settings 

> & .svn 

> & classes 


> & sre 


图 11-35 指定 生成 的 代码 的 输出 目录 


Name: Generate Ch 11 Model | 
Console configuration: | Hibernate ch 11 ie} 


Output directory: {Hibernate ch 11/src | ( Browse... 


(_) Reverse engineer from JDBC Connection 


Package: 
reveng.xm!: 
reveng. strategy: 


v Generate basic typed composite ids 
v Detect optimistic lock columns 


Vv Detect many-to-many tables 


回 Use custom templates (for custom file generation) 


图 11-36 在 Main 选 项 页 中 设置 代码 生成 的 配置 ， 以 实现 用 codegen 
Ant 构 建 目 标 完成 的 功能 


我 们 只 需要 关注 Name， 以 及 Main 选 项 卡 上 的 头 两 个 选项 ， 因 为 我 
们 并 不 打算 对 现 有 数据 做 些 奇特 的 反 向 工程 处 理 ( 哪 天 需要 将 遗留 下 
来 的 大 型 数据 库 模 式 转换 到 Java 模 型 时 ， 你 可 以 自己 再 研究 一 下 这 个 强 
大 功能 ) 。 接 着 ， 我 们 再 转移 到 Exporters (导出 ) 选项 卡 。 点 击 这 个 


选项 卡 ， 将 打开 如 图 11-37 所 示 的 程序 界面 ， 填 写 些 信息 ， 以 再 现 原来 
的 Ant 构 建 目标 的 行为 。 


General settings: 
vw Use Java 5 syntax 


(| Generate EJB3 annotations 
Exporters: 
Domain code (.java) 
| is Hibernate XML Mappings (.hbm.xml) 
© DAO code (java) 
Fy Hibernate XML Configuration (.cfg.xml) 
BG Schema Documentation (html) 


图 11-37 Exporters 配 置 ， 以 再 现 原来 的 codegen Ant 构 建 目标 


我 们 选中 了 Use Java 5 syntax 复 选 框 ， 束 相当 于 在 Ant 构 建 任务 中 设 
置 了 jdk5=true 属 性 ， 同 时 也 选中 Domain code (java) 导出 选项 。 注 
意 ， 虽 然 我 们 用 的 不 多 ， 还 是 有 很 多 其 他 导出 生成 器 可 供 我 们 用 于 创 
建 映射 文件 、 全 局 的 Hibernate 配 置 文件 甚至 是 数据 库 模 式 的 某 种 Web 文 
档 。 此 外 ， 也 可 以 创建 某 种 数据 访问 对 象 (“DAO 代码 ， 以 标准 化 、 


方便 的 方式 来 简化 对 模型 对 象 的 加 载 和 处 理 。 虽 然 与 这 些 选 项 相关 的 
主题 已 经 超出 本 书 的 讨论 范围 ， 不 过 你 可 以 目 己 研 究 它们 的 使 用 方 
法 ， 至 少 应 该 和 完 记 下 来 ， 以 备 不 时 之 需 。 


注意 : 提供 GUI 的 目的 是 为 了 解决 什么 .…… 至 少 它 们 亢 盖 了 篆 见 的 
应 用 案例 。 


可 能 你 会 问 选项 卡 克 部 的 Properties 部 分 是 做 什么 用 的 。 它 基本 上 
用 于 让 你 设置 那些 不 能 用 图 形 界面 表示 的 每 个 Exporters (导出 器 ) 参 
数 。 点 击 任何 一 个 Exporters (列表 中 的 名 字 ， 而 不 是 复 选 框 ) ， 就 会 
显示 手工 为 那个 生成 右 设 置 的 所 有 属性 ， 同 时 也 激 
活 "Add" 和 "Remove" 按 钮 ， 以 便 可 以 编辑 各 个 属性 。 对 于 有 什么 属性 ， 
以 及 它们 的 作用 ， 可 以 参考 生成 亏 的 文档 。 


Hp 


对 于 我 们 当前 的 任务 ， 就 是 要 重新 实现 以 前 用 build.xml 文 件 实现 的 
功能 ， 这 个 文件 内 部 的 那些 配置 就 是 正确 的 设置 。 事 实 上 ， 这 些 也 正 
是 我 们 真正 需要 设置 的 。 不 过 ， 在 这 里 看 一 些 Eclipse 特 定 的 选项 ， 也 
是 有 价值 的 。Refresh 〈 刷 新 ) 选项 卡 (如 图 11-38 所 示 ) 可 以 让 你 控制 
在 运行 Experters 以 后 ，Eclipse 应 该 自动 刷新 哪些 资源 。 


图 中 我 们 选择 刷新 生成 代码 所 属于 的 那个 项 目 。 似 乎 这 样 符合 我 
们 正在 进行 的 操作 。 


ra = y 
| Pp Main | E} Exporters (L Refresh ~ 加 Common | | 


| v Refresh resources upon completion. 


|| ©) The entire workspace 
O The selected resource 
(* The project containing the selected resource 


(The folder containing the selected resource 


() Specific resources ( Specify Resources... ) 


| wv Recursively include sub-folders 


图 11-38 代码 生成 后 的 刷新 选项 


最 后 ，Common (通用 ) 选项 卡 上 的 默认 设置 看 起 来 就 不 错 了 ， 不 
需要 修改 ， 点 击 "Apply" (MH) 按钮 。 


我 们 刚才 的 配置 将 出 现在 左边 的 列表 中 (如 图 11-39 所 示 ) 。 这 时 
我 们 可 以 先 选中 它 ， 再 点 击 "Run" 按 钮 (如 图 11-34 的 底部 右边 所 示 ) 
或 者 ， 如 果 我 们 认为 可 能 需要 经 常 运 行 它 的 话 ， 可 以 将 它 设置 为 工具 
条 菜单 上 的 一 个 快捷 按钮 ， 这 样 它 就 可 以 出 现在 菜单 的 顶部 了 。 从 现 
在 起 ， 我 们 只 要 从 这 个 对 话 框 中 选择 相应 的 配置 ， 再 点 击 "Run" 按 钮 
就 可 以 测试 运行 了 。 


“i 
fiii: 


CEeAXxXIO#. 


type filter text 


y 人 Hibernate Code Generation 
Q Generate Ch 11 Model 


图 


运行 它 并 不 


11-39 ”我 们 的 代码 生成 配置 现在 可 以 运行 了 


会 产生 什么 特别 的 结果 ， 只 是 Eclipse 窗 口 底 部 右边 的 


状态 栏 会 简单 地 显示 正在 进行 的 后 台 活 动 (我 们 保持 Common 选 项 卡 中 
的 Launch in background 配 置 选项 为 选中 状态 ， 这 正 是 我 们 想 要 的 结 


R) 。 要 看 看 它 是 否 做 了 些 什么 ， 可 以 找到 生成 的 类 (例如 
Album.java) 来 看 看 。 例 11-2 中 的 代码 演示 了 由 Hibernate Tools 生 成 的 
Album 类 源 代 码 的 开始 部 分 


例 11-2: Eclipse 中 的 Hibernate Tools 生 成 的 Album 类 的 源 代 码 


package com. 


//Generated 


import java. 
import java. 
import java. 
import java. 
import java. 


[ee 
*Represents 
tracks. 


oreilly.hh.data; 

Jan 5, 2008 6: 36: 04 PM by Hibernate Tools 3.2.0.CR1 
util.ArrayList; 

util.Date; 

util.HashSet; 

util.List; 

util.Set; 


an album in the music database, an organized list of 


*@author Jim Elliott (with help from Hibernate) 
大 


*/ 

public class Album implements java.io.Serializable{ 
private int id; 

private String title; 

private Integer numDiscs; 

private Set<Artist>artists=new HashSet<Artist> (0) ; 


源 文件 中 的 时 间 戳 和 工具 版 本 号 都 表明 这 个 类 是 最 新 生成 的 〈 想 
到 我 们 正在 使 用 的 Maven for the Ant tasks 中 提供 的 3.2.0.b9 版 本 ， 谁 知 
道 最 新 版 本 进入 Maven 仓 库 的 延迟 会 有 好 的 一 方面 呢 ? ) 。 男 一 方面 ， 
这 一 结 灯 看 起 来 与 Ant 生 成 的 结果 类 似 。 并 不 太 令 人 振奋 ， 或 许 我 们 已 


经 预见 到 了 这 些 。 


那 还 剩 下 什么 要 我 们 去 做 ? 像 这 样 内 建 到 Eclipse 中 的 工具 可 以 极 
大 地 市 省 项 目的 设计 和 开发 周期 。 能 够 将 查询 和 数据 库 模 式 辅 助 日 动 
完成 、 属 性 浏览 以 及 实时 SQL 显示 等 集成 在 一 起 ， 这 本 刁 束 是 一 种 理 
解数 据 和 模型 对 象 的 很 好 方法 。 本 书 前 面 为 测试 各 种 查询 而 需要 编写 
单独 的 代码 示例 ， 再 编译 、 运 行 、 调 整 它们 ， 与 这 种 党 琐 的 方法 相 
比 ， 图 形 化 工具 无 疑 更 加 快速 、 更 加 方便 。 你 可 以 快速 地 测试 许多 查 
WN, MANERA RIES (无 论 如 何 ， 使 用 Hibernate 
后 ， 这 样 的 代码 已 经 没有 多 少 了 ) 来 建立 运行 环境 。 


映射 图 表 


在 本 书 大 部 分 的 写作 时 间 内 ，Hibernate Tools 一 直 都 是 Beta 版 本 ， 
还 不 文 持 本 市 最 后 介绍 的 这 个 功能 。 地 好 ， 殊 在 本 书 交 付 印 刷 前 夕 ， 
发 布 了 3.2 的 最 终 版 本 ， 这 一 版 本 文 持 映射 图 表 。 对 象 和 数据 模型 之 间 
的 图 形 视图 对 理解 它们 之 间 的 关系 很 有 帮助 ， 现 在 Eclipse 中 就 可 以 生 
成 这 样 的 图 表 了 。 为 了 创建 图 表 ， 先 在 Hibernate Configurations 视 图 中 
选择 一 个 映射 类 ， 打 开 它 的 上 下 文 关联 沫 单 (用 鼠标 右键 点 击 元 素 或 
在 按 住 Control 键 的 同时 点 击 元 素 ， 如 图 11-40 所 示 ) ， 再 选择 Open 


Mapping Diagram ° 


这 会 生成 一 个 类 似 图 11-41 的 新 视图 。 为 了 让 视图 适合 页 面 的 大 
小 ， 这 里 选择 了 一 个 简单 的 类 ， 但 如 果 使 用 大 屏幕 ， 你 可 以 深 动 视 
图 ， 束 能 够 查看 对 象 之 间 复 洒 的 关联 关系， 信息 量 非 第 大 。 如 末 你 不 
喜欢 图 表 中 各 元 素 的 位 置 ， 可 以 随意 拖 动 它们 到 任何 地 方 ; 还 可 以 使 
用 图 表 中 的 上 下 文 关 联 菜 单 来 打开 你 感 兴 趣 的 源 文 件 和 映射 文档 。 


加 Tackhbmxml _ 


<?xml version="1.@"?> 
<!DOCTYPE hibernate-mapping PUBL? 
"http: //hibernate.sour« 


v [Ñ Hibernate ch 11 
y [Ñ Configuration 


fe © album <hibernate-mapping> 
b © A rtist 一 - BEER ope 
@ Trac zi HQL Editor f anur bam re ee 
¥ @ session 大 Hibernate Criteria Editor Represents an artist who i: 
Oco author Jim Elliott (with | 
= Oco 国 Add Configuration... eta> 


9 Rebuild configuration 
Edit Configuration 
Delete Configuration 


Refresh 
Run SchemaExport 


name="id" type="int" colur 
ta attribute="scope-set": 
enerator class="native"/> 


Open Mapping Diagram . 


| Open Source File j 
| Open Mapping File i 


© com.oreilly.hh.data Artist -> ARTIST 


E, id : int 


E name : string 


2} = Set<com.oreilly.hh.data.Track> 


E, key 


+*+ element nan 
*-LactualArtist : com.oreilly.hh.data Artist 


图 11-41 类 的 映射 图 表 


明显 地 ， 可 感知 数据 库 模 式 (schema-aware) 的 XML 和 查询 编 
辑 ， 用 于 构建 映射 和 Hibernate 配 置 的 GUI 选项 ， 这 些 相 当 有 用 的 功能 是 
将 Eclipse 作为 开发 首选 的 工具 而 获得 的 好 处 。 用 图 表 来 帮助 实现 数据 
的 可 视 化 和 理解 ， 真 古 为 Eclipse 锦 上 添 化 。 而 且 ， 能 够 与 Hibernate 会 话 
动态 地 进行 交互 ， 点 击 一 下 按钮 就 可 以 生成 代码 ， 在 IDE 中 束 可 以 运行 
查询 ， 其 至 不 用 建立 Ant 构 建文 件 束 可 以 完成 很 多 用 其 他 办 法 无 法 实现 
的 功能 。 如 果 你 正在 考虑 这 些 文字 介绍 ， 对 如 何 才 能 不 需要 很 及 烦 地 
手工 将 Maven 资 源 添加 到 类 路 径 中 而 感 兴趣 ， 下 一 章 将 会 为 你 独 尽 蹊 


fa 


第 12 音 ”Mavenj 井 阶 


如 有 果 从 O'Reilly 的 网 站 下 载 我 们 的 示例 代码 ， 你 会 发 现 每 一 章 的 示 
例 目录 都 包含 一 个 神秘 的 pom.xml 文 件 ， 我 们 还 没有 介绍 过 这 个 文 
件 。pom.xml 生 Apache Maven 这 个 构建 工具 的 配置 文件 ， 现 在 这 个 工 
具 已 经 广泛 用 于 取代 Apache Ant。 对 Maven 完 整 的 介绍 不 在 本 书 讨论 
的 范围 以 内 ， 不 过 ， 我 们 觉得 这 里 介绍 些 有 关 如 何 随 Hibernate 一 起 安 
半 和 使 用 Maven， 这 些 应 该 够 用 了 “。 本 章 旨 在 为 Maven 提 供 最 简洁 的 
介绍 ， 重 点 说 明 Maven 和 Hibernate3 揪 件 的 使 用 ， 顺 便 也 会 介绍 一 些 


Maven 的 核心 概念 。 


什么 是 Maven 


Maven 是 一 种 声明 式 (declarative) 的 构建 工具 ， 它 不 是 定义 一 套 
用 于 构建 项 目的 过 程 步骤 ， 而 是 用 保存 在 pom.xml 文 件 中 的 Project 
Object Model (POM, 项 目 对 象 模型 来 指 述 项 目 。 担 当 重 任 的 Maven 
插件 ， 它 们 知道 如 何 读 取 POM 文 件 和 完成 任务 。 例 如 ， 默 认 的 Maven 
插件 可 以 编译 代码 、 创 建 JAR 文 件 、 组 装 WAR 文 件 、 创 建 Web 网 站 、 
为 JAR 文 件 生成 数字 签名 (sign) 、 计 算 代 码 质量 度量 (code 
metrics) 、 执 行 单元 测试 、 读 取 Hibermate 上 映射 文 件 等 。 使 用 Maven,， 
你 所 有 需要 做 的 就 是 告诉 它 源 代码 在 哪里 ， 需 要 依赖 什么 文件 ， 


Maven 足 够 聪明 ， 它 会 明日 接 下 来 应 该 做 什么 。 如 琳 不 用 Maven， 而 

征 使 用 像 Apache Ant 这 样 的 工具 ， 束 得 定义 一 个 显 式 的 构建 过 程 。 如 
前 所 述 ，Maven 采 用 声明 式 的 方法 来 构建 和 测试 一 个 项 目 ， 作 为 Ant 的 
ean, EAR RBS El T WOH ° 


注意 : Maven 可 以 为 你 市 约 很 多 时 间 ， 但 是 你 要 去 学 习 和 习惯 
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获得 方便 的 同时 也 需要 付出 一 定 的 代价 。Maven 之 所 以 知道 如 何 
处 理 你 的 项 目的 源 代码 、 配 置 以 及 单元 测试 ， 是 因为 它 做 了 一 些 假 
设 。 首 先 ，Maven 假 设 你 的 项 目 采 用 的 是 标准 布局 和 构建 生命 周期 。 
所 以 ， 在 使 用 Maven 之 前 ， 我 们 希望 你 确实 知道 了 Maven 的 这 些 核心 
假设 。 一 个 假设 就 古 对 项 目的 定义 。 在 Maven 中 ， 一 个 project 是 由 源 
代码 和 资源 组 成 的 ， 每 个 资源 与 一 个 artifact 对 应 。 这 个 artifact 可 以 是 
类 似 JAR 或 WAR 之 类 的 文件 ， 不 过 ， 需 要 知道 的 一 个 重点 就 十 一 个 项 
目 只 有 一 个 artifact。 男 一 个 假设 是 (大 多 数 情 况 下 ) 你 应 该 使 用 标准 
的 目录 布局 。 在 pom.xml 文 件 中 可 以 对 Maven 的 大 部 分 默认 设置 进行 修 
改 。 如 果 你 不 想 将 源 代码 保存 在 src/main/java 目 录 中 ， 则 可 以 在 


pom.xml 中 指定 男 一 个 目录 。 


注意 : 如 果 你 不 喜欢 Maven 的 约定 ， 可 以 考虑 换个 工具 。 


如 果 你 喜欢 Maven， 但 手边 的 儿 个 项 目 确实 不 能 完全 满足 Maven 
假设 的 要 求 ， 也 不 必 放 弃 Ant。 事 实 上 ，Maven 在 现 有 的 Ant 构 建文 件 
中 对 它 进 行 调用 也 提供 了 方便 的 机 制 。 除 了 本 章 少 数 几 个 示例 以 外 ， 
本 书 的 大 部 分 示例 就 以 Ant 构 建文 件 作 为 基础 。 如 果 你 下 载 随 书 的 示例 
代码 ， 束 会 发 现 本 章 特殊 的 示例 具有 与 其 他 章节 不 同 的 目录 布局 。 我 
们 研究 一 下 这 种 目录 结构 ， 也 就 是 Maven 中 所 谓 的 标准 目录 布局 
(Standard Directory Layout) 。 


有 天 Maven 更 详细 的 介绍 ， 可 以 阅读 Sonatype 的 《Maven: The 


Definitive Guide) ('!) œ 


Maven 的 标准 目录 布局 


理想 的 构建 工具 应 该 能 够 目 动 知道 如 何 处 理 一 套 Java 源 文件 。 这 
样 的 系统 将 会 具有 一 定 的 内 建 智能 ， 可 以 让 你 简单 地 编写 一 定 的 源 代 
码 ， 再 将 简单 的 文件 放 在 项 目 根 (root) 目 未 下， 运行 构建 工具 ， 再 
回 到 项 目 目 了 未。 构建 工具 会 认为 你 的 项 目 包 侣 一 定 的 Java 源 代码 ， 你 
想 根据 它们 而 生成 一 个 JAR 文 件 。 如 采 你 想 生 成 的 是 WAR 文 件 ， 束 应 
该 提供 一 些 提示 ， 以 修改 构建 工具 的 默认 行为 。 


这 种 思想 已 经 由 Maven 实 现 『， 人 至 少 实现 了 一 部 分 ， 因 为 Maven 
提供 了 一 套 严 格 的 约定 ， 消 除了 大 部 分 常见 配置 的 需要 。 这 就 是 所 谓 


的 “约定 优 于 配置 ”(convention over configuration) ， 在 过 去 几 年 中 这 
种 思想 在 Ruby on Rails 之 类 的 框架 中 变 得 非常 流行 ， 它 让 你 即便 是 编 
写 非 常 复杂 的 Web 应 用 程序 也 不 必 为 不 计 其 数 的 配置 文件 而 费心 (第 
14 章 介绍 的 Stripes 也 采用 了 Java 业 界 的 类 似 方法 ) 。 约 定 优 于 配置 ， 
这 也 是 为 什么 Apple 笔 记 本 电脑 总 是 可 以 开 箱 即 用 (out of the box) 的 
原因 ， 也 是 为 什么 在 区 驶 汽车 前 你 不 用 阅读 它 的 使 用 手册 融 知 道 油 | 
在 右边 而 刹车 在 左边 的 原因 。 通 过 同样 的 策略 (如 果 你 已 经 遵守 了 约 
E) ，Maven 就 会 自动 知道 你 的 源 代码 、 单 元 测试 、 网 站 文档 以 及 配 
置 文件 都 在 什么 地 方 ， 而 不 用 银 费 你 宝贵 的 时 间 杀 上 自 告 诉 Maven 这 些 
东西 都 放 在 哪儿 。 例 12-1 显 示 了 Maven 的 项 目 目录 布局 的 大 致 样子 。 


例 12-1: Maven 的 标准 目录 布局 
pom. Xml 


每 个 项 目 都 必须 有 一 个 pom.xml 文 件 ( 即 一 个 POM) 。 本 章 后 面 


的 第 12.6 节 将 详细 介绍 POM 文 件 。 
src/ 
在 这 个 子 日 录 中 保存 各 种 源 文件 。 


src/main/java/ 


将 要 包含 在 最 终 artifact (JAR 文 件 、WAR 文 件 等 ， 中 的 Java 源 代 
码 位 于 这 个 目 永 。 


src/main/resources/ 


这 个 目录 包含 项 目 需 要 的 各 种 资源 ， 非 Java 源 代码 、 类 似 
log4j.properties 的 东西 、hibernate.cfg.xml、 本 地 化 (localization) 文件 
以 及 需要 发 布 的 Hibernate 映 射 文件 。 


src/test/java/ 

保存 Unit 测 试 代码 (TestNG 或 JUnit 测 试 ) 
src/test/resources/ 

保存 只 供 测试 使 用 的 资源 。 

src/site/ 

网 站 文档 保存 目录 。 


target/ 


构建 过 程 生成 的 任何 东西 ， 可 以 是 源 代码 、 字 节 码 或 最 终 的 产 
品 ， 都 将 保存 在 target 目 录 中 。 因 为 target 中 的 文件 是 构建 过 程 的 产物 ， 
所 以 可 以 随意 删除 ， 不 应 该 包括 在 版 本 控制 (version control) 中 。 


还 有 一 些 其 他 目录 ， 比 如 src/main/webapp 、src/main/config ` 
src/main/assembly 以 及 src/main/filters， 这 里 不 对 它们 进行 过 多 的 介绍 ， 
在 充分 利用 Maven 创 建 复杂 的 应 用 程序 时 ， 这 些 目 录 都 有 各 自 不 同 的 
用 途 。 例 如 ， 如 果 我 们 要 生成 一 个 WAR 文 件 ， 则 src/main/webapp 将 是 
Web 应 用 程序 的 文档 根 目 录 。 如 果 我 们 为 命令 行 应 用 程序 创建 一 个 目 
定义 的 文档 包 ， 则 src/main/assembly 目 前 用 于 保存 我 们 将 要 使 用 的 装配 
描述 符 (assembly descriptor) 。 例 12-1 中 列举 的 那些 目录 将 出 现在 每 


个 Maven 项 目 中 ， 它 们 是 Maven 项 目 最 低 的 公共 约定 标准 。 


虽然 这 些 看 起 来 似乎 是 相对 简单 的 想法 ， 但 业界 目前 还 没有 对 
Java 项 目的 标准 目录 布局 之 类 的 事 达 成 一 致 。 事 实 上 ， 反 对 使 用 
Maven 最 常见 的 一 个 理由 就 是 人 们 不 喜欢 Maven 约 定 的 目录 结构 。 其 
实 你 可 以 容易 地 自 定义 这 种 目录 结构 ， 如 果 你 看 看 本 书 其 他 章节 的 示 
例 代码 ， 就 会 发 现 我 们 采用 的 也 是 自己 的 目录 布局 结构 。 这 种 方法 也 
有 一 些 缺 点 ， 例 如 ， 由 于 使 用 上 自 定 义 目 录 布 局 而 引起 的 微妙 问题 ， 有 
儿 半 示例 就 与 Maven Hibernate3 插 件 并 不 完全 兼容 。 所 以 我 向 你 再 次 警 
告 ， 尽 可 能 不 要 试图 让 Maven 适 应 你 的 项 目的 自 定 义 目录 布局 ， 而 是 
在 自 定义 之 前 调整 你 的 项 目 以 适应 Maven 的 标准 目录 布局 。 不 过 有 些 
简单 的 区 别 也 不 会 给 Maven 造 成 任何 问题 ， 比 如 将 资源 保存 到 
src/main/java 目 录 下 ， 或 者 配置 Maven， 让 它 把 源 代码 保存 到 src/java 目 
录 而 不 是 src/main/java 目 录 下 。 束 像 Maven 对 源 代码 有 一 定 的 标准 一 
样 ， 它 对 工具 生成 的 源 代码 也 有 一 定 的 约定 (这 些 代码 文件 最 终 位 于 


target/generated-source 目 录 下 ， 它 们 包含 在 "compile source roots" 列 表 
中 ， 所 以 它们 将 与 你 自己 编写 的 代码 一 起 进行 编译 ) 


注意 : 本 章 的 主题 或 者 是 “接受 Maven 的 约定 ”， 或 者 是 “你 将 被 同 
化 。 抵 抗 是 没 用 的 ”。 


如 有 果 当 你 读 完 本 市 后 会 想 “ 嗯 ， 我 们 有 更 好 的 目录 布局 ?， 非 常 不 
举 ，Maven 不 适合 你 了 。 如 果 你 想 试图 调整 一 些 Maven 的 核心 假设 ， 
可 能 要 人 花费 好 些 天 来 对 付 一 系列 莫名 其 妙 的 问题 。 最 后 ，Maven 跑 不 
起 来 了 ， 你 将 开始 大 声 地 诅咒 Maven， 接 着 在 博客 上 发 帖子 说 你 有 多 
么 多 么 地 讨厌 它 ， 这 一 切 都 因为 你 不 愿意 接受 Maven 基 本 的 假设 。 可 
能 你 还 没有 注意 到 ， 本 章 开 始 的 几 节 都 在 尽 可 能 地 为 你 节省 时 间 。 我 
可 以 证 明 Maven 为 了 市 省 了 无 数 的 时 间 和 精力 ， 从 效率 的 角度 来 说 ， 
给 了 我 意外 的 收获 。 但 是 我 也 看 到 有 些 人 使 用 Maven 的 方 同 就 古 错误 
的 ， 最 终 除 了 对 Maven 的 不 满 以 外 ， 项 目 上 一 无 所 获 。 适 应 Maven， 
而 不 是 让 Maven 适 应 你 。 这 些 已 经 接近 事实 ， 但 如 果 你 一 开始 束 质 疑 
这 些 事 实 的 话 ， 受 伤 的 就 只 能 是 你 目 己 。 


[1] http://www.sonatype.com/book/index.html. 
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2 Maven 

Maven 的 二 进 制 发 行 版 本 可 以 从 
http://maven.apache.org/download.html 下 载 ， 下 载 适合 你 使 用 的 格式 的 
当前 最 新 版 本 ， 为 它 选 择 一 个 合适 的 保存 位 置 ， 并 在 那里 解 开 压缩 
包 。 如 果 你 将 文档 解压 到 类 似 /usr/local/maven-2.0.8 这 样 的 目录 中 ， 则 
可 能 还 应 该 创建 一 个 到 这 个 目录 的 符号 链接 以 方便 使 用 ， 这 样 ， 在 更 
新 到 新 版 本 时 也 不 必修 改 环境 配置 : 

/usr/local%ln-s maven-2.0.8 maven 


/usr/local%export M2_HOME=/usr/local/maven 
/usr/local%export PATH=${PATH}: ${M2_HOME}/bin 


在 安装 好 Maven 后 ， 还 需要 做 两 件 事情 ， 才 能 让 Maven 正 常 运 
行 。 你 需要 将 Maven 的 bin 目 录 (在 这 个 例子 中 古 /usr/local/maven/bin) 
添加 到 命令 行路 径 中 。 还 需要 设置 环境 变量 M2_HOME， 让 它 指 回 
Maven 安 装 的 顶级 目录 (在 这 个 例子 中 是 /usr/local/maven) 。 有 关 如 何 
在 各 种 不 同 的 操作 系统 中 执行 这 些 安装 步骤 的 细节 ， 可 以 参阅 
«Maven: The Definitive Guide》 一 书 。 


项 目的 构建 、 测 试 以 及 运行 


假设 你 已 经 从 本 书 的 网 站 (1) 下 载 好 了 示例 代码 ， 这 时 应 该 转 


到 ch12 示 例 目 录 ， 运 行 mvn test 命 令 。 运 行 结果 如 图 12-2 所 示 。 


例 12-2: 告诉 Maven 测 试 我 们 的 项 目 


$mvn test 
[INFO]Scanning for projects.…@ 
[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 

[INFO] 

task-segment: [test] 
[INFO]---------------------------------------------------------- 


[INFO][resources: resources] 

[INFO]Using default encoding to copy filtered resources. 

[INFO][compiler: compile]® 

[INFO]Compiling 9 source files to~\examples\chi2\target\classes 

[INFO]Preparing hibernate3: hbm2dd1 

[WARNING]Removing: hbm2dd] from forked lifecycle, to prevent 
recursive 

invocation. 

[INFO][resources: resources] 

[INFO]Using default encoding to copy filtered resources. 

[INFO][hibernate3: hbm2ddlf{execution: generate-dd1}]® 

[INFO]Configuration XML file loaded: 

~/examples/chi2/src/main/resources/hibernate.cfg. xml 

20: 16: 05, 580 INFO org.hibernate.cfg.annotations.Version- 
Hibernate 

Annotations 3.2.0.GA 

20: 16: 05, 595 INFO org.hibernate.cfg.Environment-Hibernate 
3.2.0.cr5 

20: 16: 05, 598 INFO org.hibernate.cfg.Environment - 
hibernate.properties 

not found 


20: 16: 05, 599 INFO org.hibernate.cfg.Environment -Bytecode 
provider name 

: cglib 

20: 16: 05, 603 INFO org.hibernate.cfg.Environment-using JDK 1.4 
java.sql 

.Timestamp handling 

[INFO]Configuration XML file loaded: 

~/examples/chi2/src/main/resources/hibernate.cfg. xml 

20: 16: 05, 684 INFO org.hibernate.cfg.Configuration-configuring 
from url: 

~/examples/chi2/src/main/resources/hibernate.cfg.xml 

20: 16: 05, 808 INFO org.hibernate.cfg.Configuration-Configured 
SessionFactory: 

null 

(schema export omitted) 

20: 16: 07, 172 INFO org.hibernate.tool.hbm2dd1.SchemaExport- 
schema export 

complete 

20: 16: 07, 173 INFO 
org.hibernate.connection.DriverManagerConnectionProvider 

-cleaning up connection pool: jdbc: hsqldb: data/music 

[INFO][resources: testResources | 

[INFO]Using default encoding to copy filtered resources. 

[INFO][compiler: testCompile]® 

[INFO]Compiling 2 source files to~\examples\chi2\target\test - 
classes 

20: 16: 08, 194 INFO 
org.hibernate.connection.DriverManagerConnectionProvider 

-Cleaning up connection pool: jdbc: hsqldb: data/music 

[INFO][surefire: test]® 

[INFO]Surefire report directory: ~ 
\examples\chi2\target\surefire-reports 


Running com.oreilly.hh.ArtistTest 

Hibernate: insert into ARTIST (ARTIST_ID, actualArtist_ARTIST_ID, 
NAME) 

values (null, ?, ?) 

Hibernate: call identity () 

Tests run: 1, Failures: 0, Errors: 0, Skipped: ©, Time elapsed: 
1.345 sec 

Results: 

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


这 个 命令 进行 了 很 多 活动 ， 我 们 来 看 看 刚才 发 生 了 什么 : 


OHZ, mv test 是 什么 意思 ? 在 命令 行 中 ， 我 们 调用 Maven， 并 
向 它 传递 Maven 构 建生 命 周期 (Maven Build Lifecycle) 中 目标 阶段 的 
名 称 。Maven 构 建生 命 周期 是 Maven 在 构建 项 目 时 经 历 的 一 组 阶段 。 
在 生命 周期 的 各 个 阶段 中 ， 需 要 为 了 执行 而 注册 不 同 的 插件 : 在 编译 
阶段 要 对 代码 进行 编译 ， 在 测试 阶段 要 执行 各 种 测试 ， 在 打包 阶段 要 
创建 JAR 包 。 有 关 Maven 构 建生 命 周期 各 阶段 的 完整 列表 ， 可 以 参阅 
本 章 后 面 的 “Maven 构 建 的 生命 周期 "一 入。 


@ 要 到 达 测 斌 阶段， 必须 先 通 过 编译 阶段 。 在 编译 阶段 需要 注册 
并 运行 Maven Compiler 插 件 。Maven 插 件 是 由 不 同 的 目标 (goal) 组 成 
的 ， 我 们 可 以 看 到 执行 了 编译 目标 ， 编 译 了 9 个 源 文 件 ， 生 成 的 字 节 码 
文件 放 到 了 target/classes 中 。 我 们 如 何 判 断 编 译 器 插件 已 经 执行 了 编译 
目标 ? [compiler: compile] 告 诉 我 们 这 一 信息 ， 在 Maven 的 输出 中 ， 你 
会 看 到 很 多 类 似 的 信息 。 冒 号 之 前 的 字符 串 部 分 是 插件 标识 符 (plug- 
in identifier) ， 之 后 是 正在 被 执行 的 目标 标识 符 (goal identifier) 。 注 
意 ，compiler: compile 下 面 几 行 有 一 条 警告 性 质 的 日 志 语 句 ， 目 前 你 
可 以 放心 地 忽略 它 。 


目 接 着 ， 我 们 可 以 看 到 正在 执行 的 是 Hibernate3 插 件 的 hbm2ddl 目 
标 。 这 个 插件 不 是 默认 插件 ， 必 须 在 Maven 中 明确 地 添加 这 个 插件 ， 
不 过 ， 不 必 为 它 提供 很 多 配置 。 这 个 插件 假设 hibernate.cfg.xml 位 于 


src/main/resources 目 好 中 。 我 们 将 在 后 面 的 “使 用 Maven Hibernate3 插 
件 ” 一 节 中 详细 地 介绍 Hibernate3 Maven 搬 件 。 


@ 接 着 ， 编 译 单元 测试 。 编 译 器 插件 有 一 个 名 为 testCompile 的 目 
标 。 编 译 好 的 测试 字 节 码 保存 在 target/test-classes 目 未 中 。 


日 最 后 ，Surefire 插 件 执行 test 目 标 ， 在 生成 的 测试 类 中 寻找 扩展 目 
JUnit 的 TestCase 类 的 测试 类 。 在 这 个 例子 中 ， 我 们 编写 了 一 个 简单 的 
JUnit 测 试 ， 向 ARTIST 表 插入 一 个 测试 值 。 


Maven 刚 才 在 幕后 的 操作 束 是 编译 源 代 码 、 创 建 一 个 HSQLDB 数 
据 库 、 编 译 单元 测试 、 运 行 一 个 单元 测试 以 便 在 数据 库 中 插入 一 行 数 
据 。 如 采 你 想 重 复 该 示例 ， 删 除数 据 目 录 或 单元 测试 将 导致 癌 数 据 库 
中 插入 一 行 数据 时 会 失败 ， 因 为 这 样 会 违反 在 世人 名 称 上 施加 的 惟一 
性 约束 限制 条 件 。 为 了 清除 挥 整个 项 目 ， 应 该 运行 mvn clean 命 令 : 


$mvn clean 
[INFO]Scanning for projects... 
[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 

[INFO] 

task-segment: [clean] 
[INFO]---------------------------------------------------------- 


[INFO][clean: clean] 

[INFO]Deleting directory~\examples\chi2\target 
[INFO]Deleting directory~\examples\chi2\target\classes 
[INFO]Deleting directory~\examples\chi2\target\test-classes 
[INFO]Deleting directory~\examples\chi2\target\site 


如 果 你 打算 在 其 他 项 目 中 也 利用 这 个 项 目的 类 ， 你 可 能 希望 生成 
一 个 JAR 文 件 ， 并 将 其 保存 在 类 路 径 中 。 为 了 生成 一 个 JAR， 应 该 运 
行 mvn package 命 令 : 
$mvn package 


[INFO]Scanning for projects... 
[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [package] 
[INFO] ---------------------------------------------------------- 


a skipping output... 

[INFO][jar: jar] 

[INFO]Building jar: ~\examples\ch1i2\target\hib-dev-chi2-2.0- 
SNAPSHOT. jar 


我 们 对 这 个 示例 的 输出 进行 了 大 量 删 减 ， 因 为 它 与 前 面 的 mvn test 
的 输出 差不多 是 一 样 的 。 在 此 之 后 是 Jar 揪 件 的 jar 构 建 目 标的 输出 ， 我 
们 显示 了 这 一 内 容 。Jar 插 件 绑 定 到 了 Maven 构 建生 命 周 期 的 打包 阶 


段 ， 它 创建 了 一 个 名 为 hib-dev-ch12-2.0-SNAPSHOT.jar 的 JAR 目 标 


artifact 。 


[1] http://www.oreilly.com/catalog/9780596517724/. 


使 用 Maven 生 成 IDE 项 目 文 件 


在 上 一 下 中 ， 你 创建 了 一 个 数据 库 、 编 译 了 代码 、 对 代码 进行 了 
测试 并 将 最 终 的 生成 结果 打包 到 JAR 中 ， 但 是 这 些 还 只 是 Maven 能 够 
做 到 的 一 部 分 。 Maven 有 许多 插件 ， 不 过 它们 一 般 不 直接 附加 到 
Maven 的 生命 周期 中 。 一 些 项 目的 一 个 常见 功能 就 是 为 集成 开发 环境 
(IDE, Integrated Development Environment) 提供 配置 文件 。 通 常 一 个 
团队 将 会 使 用 一 种 标准 的 开发 环境 ， 如 IntelliJ、Eclipse、NetBeans 或 
者 Emacs JDE， 为 这 些 工具 提供 的 配置 文件 也 将 是 项 目的 一 部 分 。 如 
果 一 个 团队 具有 一 套 标准 的 工具 ， 那 将 IDE 配 置 文件 保存 在 版 本 控制 
工具 中 可 能 更 有 意义 。 


注意 : 大 多 数 人 都 有 各 目 喜 欢 的 开发 工具 ， 所 以 ， 从 POM 中 生成 
IDE 项 目 可 以 让 每 个 人 都 使 用 他 们 觉得 最 有 效率 的 工具 。 


当 团 队 并 没有 使 用 一 套 统一 的 工具 时 ， 在 版 本 控制 工具 中 保存 
IDE 配 置 显 得 没有 多 大 意义 。 束 以 大 多 数 开 源 项 目 为 例 ， 参 与 项 目的 
每 个 人 之 间 很 少 有 或 根本 没有 交流 ， 也 没有 能 力 协调 彼此 之 间 开 发 平 
台 和 IDE 的 选择 。 即 使 你 认为 不 会 有 项 目 允 许 单独 的 开发 人 员 可 以 独 
立地 选择 自己 的 开发 工具 集 ， 从 Maven 中 生成 IDE 配 置 文件 也 有 一 定 的 
好 处 。 这 些 配置 文件 通常 都 包含 了 同样 的 依赖 信息 、 标 识 符 以 及 设 


置 ， 可 以 将 这 些 信息 保存 在 pom.xml 文 件 中 。 如 果 不 从 pom.xml 中 生成 
IDE 配 置 ， 就 必须 保存 和 维护 多 份 这 些 信息 的 复 本 。 


为 了 生成 一 套 Eclipse 配 置 文件 ， 可 以 从 ch12 示 例 目录 中 运行 mvn 


eclipse: eclipse 命 令 : 


$mvn eclipse: eclipse 

[INFO]Scanning for projects... 

[INFO]Searching repository for plugin with prefix: 'eclipse'. 
[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 

[INFO]task-segment: [eclipse: eclipse] 

[INFO] - - ---- ee eens 

[INFO]Preparing eclipse: eclipse 

[INFO]No goals needed for project-skipping 

[INFO][eclipse: eclipse] 

[INFO]USing source status cache: ~\examples\ch12\target\mvn- 
eclipse-cache 

.properties 

[INFO]Wrote settings to~ 
\examples\chi2\.settings\org.eclipse.jdt.core.prefs 

[INFO]Wrote Eclipse project for"hib-dev-chi2"to~\examples\chi12. 


Maven 只 是 使 用 pom.xml 中 的 信息 来 生成 项 目 目录 中 的 Eclipse 项 目 
文件 (.project 和 .classpath 配 置 文件 ) 。 要 将 生成 的 项 目 导 入 到 Eclipse 
中 ， 在 Eclipse 中 选择 File- Import (导入 ) 菜单 选项 ， 在 Import 对 话 框 
中 ， 展 开 General (普通 ) 部分， 选择 "Existing Projects into 
Workspace" (导入 现 有 的 项 目 到 工作 空间 ) ， 再 点 击 "Next" 按 钮 。 在 
接 下 来 的 界面 中 通过 浏览 器 导航 到 示例 目录 ， 并 选择 示例 的 根 目录 ， 


再 点 击 "Next" 按 钮 。Eclipse 这 时 束 会 在 所 选择 的 目录 及 其 所 有 子 目 录 
中 搜索 .project 文 件 。 在 成 功 导 入 项 目 以 后 ， 还 需要 添加 一 个 名 为 
M2_REPO 的 Java Classpath Æ, LEE TSIe)]~/.m2/repository ° Alt, FJ 


开 Eclipse 的 Preferences 设 置 ， 在 Java/Build Path/Classpath Variables {3 = 
下 ， 你 可 以 看 到 包括 ECLIPSE_HOME 在 内 的 一 列 已 经 有 的 Classpath 
Variables (类 路 径 变 量 ) 。 添 加 一 个 名 为 M2_REPO 的 新 Classpath 
Variable， 并 让 它 指向 你 的 本 地 Maven2 仓 库 ， 在 这 个 例子 中 应 该 是 


~/.m2/repository ° 


只 需要 添加 一 次 M2_REPO 类 路 径 变 量 ， 而 且 如 果 你 不 喜欢 通过 
Eclipse Preferences 来 添加 类 路 径 变 量 的 方法 ， 也 可 以 使 用 Maven 
Eclipse 插件 将 类 路 径 变 量 添 加 到 你 的 Eclipse 工作 空间 中 ， 如 下 所 示 : 

/home/tobrien$mvn-o eclipse: add-maven-repo\ 


-Declipse.localRepository=~/.m2/repository\ 
-Declipse.workspace\=~/eclipse 


本 书 所 有 革 市 的 示例 都 包 合 了 一 个 pom.xml 文 件 ， 但 它们 并 非 都 
完全 兼容 Maven。 不 过 ， 在 每 一 章 中 有 一 件 事 ， 你 可 以 放心 地 去 做 ， 
那 就 是 使 用 mvn eclipse: eclipse 命 令 来 生成 Eclipse 项 目 文 件 。 试 一 下 ! 
再 换 到 其 他 章 的 示例 目录 ， 运 行 mvn eclipse: eclipse， 再 导入 那 一 章 
到 Eclipse 中 。 或 者 ， 如 果 你 想 为 所 有 章节 一 次 性 地 生成 Eclipse 项 目 文 
件 ， 则 可 以 先 转 到 所 有 章节 示例 的 父 目 录 ， 再 从 那里 运行 run mvn 
eclipse: _ eclipse 命令。 从 examples 目 录 运 行 该 命令 将 会 为 所 有 子 模块 执 


行 Eclipse 插件 的 eclipse 构 建 目 标 ， 每 一 章 的 代码 示例 都 有 一 个 eclipse 构 
建 目 标 。 


除了 Eclipse 项 目 ， 你 也 可 以 为 Intellij 的 Idea IDE 生 成 项 目 配置 。 为 
此 ， 可 以 按 以 下 方式 执行 Idea 插 件 的 idea 构 建 目 标 : 


$mvn idea: idea 

[INFO]Scanning for projects... 

[INFO]Searching repository for plugin with prefix: ‘idea’. 
[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [idea: idea] 
[INFO]---------------------------------------------------------- 


[INFO]Preparing idea: idea 

[INFO]No goals needed for project-skipping 

[INFO][idea: idea] 

[INFO]jdkName is not set, using[java version1.6.0_02]as default. 


idea 构 建 目 标 会 在 项 目 目录 中 创建 3 个 文件 : hib-dev-ch12.iml ` 
hib-dev-ch12.ipr 以 及 hib-dev-ch12.iws， 用 这 些 文件 束 可 以 将 该 项 目 导 
入 到 Idea 了 。 


用 Maven 生 成 报告 


可 外 


我 们 已 经 构建 了 一 个 项 目 ， 现 在 准备 生成 一 些 简 单 的 报告 。 一 种 
的 报告 形式 就 是 用 于 显示 单元 测试 结果 的 HTML 页 面 。 测 试 成 功 还 


征 失 败 了 ? 哪些 测试 失败 了 ? 你 也 可 以 为 代码 提供 JavaDoc， 对 代码 添 
加 标注 ， 以 方便 查阅 。 所 有 这 些 都 生成 好 以 后 ， 可 以 运行 命令 mvn 


site: 


$mvn site 
[INFO]Scanning for projects...... 
[INFO] sesso oe 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [site] 
[INFO] sees tt eb eee ese eee eee eee r eed eee 


[INFO]Setting property: classpath.resource.loader.class= 


>'org.codehaus 


KKK 


.plexus.velocity.ContextClassLoaderResourceLoader'. 
[INFO]Setting property: velocimacro.messages.on=>'false'. 
[INFO]Setting property: resource.loader=>'classpath'. 
[INFO]Setting property: resource.manager.logwhenfound=>'false'. 


[INFOJ EAE A a a EAE E EARR AEEA 


[INFO]Starting Jakarta Velocity v1.4 

[INFO] [site: site] 

Constructing Javadoc information...... 

Standard Doclet version 1.6.0_02 

Building tree for all the packages and classes... 
Generating~/examples/chi2/target/site/apidocs\index.html...... 
[INFO]Generate"Source Xref"report. 
[INFO]Generate"Continuous Integration"report. 
[INFO]Generate"Dependencies"report. 
[INFO]Generate"Issue Tracking"report. 
[INFO]Generate"Project License"report. 


[INFO]Generate"Mailing Lists"report. 
[INFO]Generate"About"report. 
[INFO]Generate"Project Summary"report. 
[INFO]Generate"Source Repository"report. 
[INFO]Generate"Project Team"report. 

inal Memory: 
INFO]Final M y: 23M/42M 


以 上 输出 片段 有 相当 多 的 删 减 。 如 琳 你 运行 mvn site， 将 能 够 看 到 
页 面 和 活动 的 页 面 。Maven 创 建 了 一 个 项 目 网 站 ， 并 生成 了 一 些 有 用 的 
报告 。 以 下 我 们 快速 浏 哆 一 下 结 
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图 12-1 生成 Maven 的 网 站 


Maven 生 成 的 简单 网 站 上 列 出 了 许多 与 项 目 有 关 的 报告 和 页 面 。 虽 
然 默 认 的 网 站 模板 看 起 来 不 算 太 好 ， 如 图 12-1 所 示 ， 但 它 确 实 提供 了 一 
个 基本 的 网 站 ， 你 可 以 此 为 基础 来 在 线 发布 有 关 项 目的 信息 。 如 果 项 
目的 POM 配 置 正确 ， 就 可 以 生成 一 个 简单 的 页 面 ， 列 出 了 项 目的 成 
员 、 许 可 协议 以 及 一 个 指向 问题 管理 工具 (如 Bugzilla、JIRA 或 Trac) 


的 链接 。 如 果 你 正在 创建 一 个 开源 项 目 ， 这 些 信息 足以 构成 一 个 公共 
的 、 面 向 开发 人 员 的 网 站 的 坚实 基础 。 即 便 你 是 在 一 个 封闭 的 环境 中 
开发 项 目 ， 这 样 的 网 站 对 开发 团队 来 说 也 是 有 用 的 。 默 认 Maven 网 站 的 
感 观 风 格 有 许多 需要 改进 之 处 ， 可 以 使 用 保存 在 src/site 目 录 下 的 样式 表 

(stylesheets) 和 模板 来 进行 定制 。 如 果 点 击 导航 荣 单 左边 的 Project 
Reports (项 目 报 告 ) 链接 ， 就 可 以 看 到 一 些 有 用 的 报告 。 还 可 以 浏览 
项 目的 JavaDoc， 如 图 12-2 所 示 。 


一 | comoreilly.hh.data 


All Classes 4 
-| Class Artist 
Packages 
com orgély hh java. lang. Ieg 
com, oreilly hhdate Leom. pe hh. data. Artist 
All Classes 
Algum public class Artist. 
AlbumTeast extends java. lang-Object 
AlbumTrack 
Artist 
CreateTest 
QueryTest 
er hiad Constructor Summary 
SiarecValumea Artisti) 
Track 
Artist (java.lang.String name, Java.util.Hashšet<TŤrack> tracks, 
Artist actualArtist} 


图 12-2 网 站 内 的 项 目 JavaDoc 页 面 


所 击 Surefire 报 告 链接 ， 殊 可 以 浏览 单元 测试 的 结 采 (如 图 12-3 所 
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com.oreilly.hh 


ce ArtistTest 1 o Li] G 100 1.275 


图 12-3 项 目的 单元 测试 结果 页 面 


因为 这 个 项 目 只 定义 了 一 个 单元 测试 ， 所 以 Surefire 报 告 没 有 多 少 
内 容 。 如 宁 项 目 中 包含 了 大 量 的 测试 ， 束 可 以 在 这 个 报告 中 检查 代码 
的 总 体质 量 。 如 果 发 现 单 元 测试 有 问题 ， 或 者 如 果 想 查找 代码 中 特定 


的 某 一 错误 ， 就 可 以 使 用 JXR 报 告 来 浏览 经 过 标注 的 、 交 叉 引 用 
(cross-referenced) 的 源 代 码 (如 图 12-4 所 示 ) ° 


import java.sql.Time; 


上 he bx 


- 
All Classes 
L 10 dmport java.util.*; 
wa ii 
Packages | ra 
工 3 “ Create sample data, letting Hibernate persist it for us. 
com.oreily hh = |14 */ 
4 ili |> 15 public class CreateTest [ 
— 16 
17 fttt 
All Classes 18 * Look up an artist record given & name. 
is * @param name the nape of the artist desired. 
Album 20 * @param create controls whether a new record should be crea 
AlbumTest zh * the specified artist is not yet in the database. 
AlbumTrack 22 * @param session the Hibernate session that can retrieve dat 
Artist - * @return the artist with the specified name, or <code>null« 
Pe cal 2 = Such artist @xists and <cede>create</code> is <cac 
CreateTest 25 * 6 aiii HibernateException if there is a problem. 
SourceMedia 27 pbiie static Artist getArtist (String name, boolean create, 3 
StereoVolume 28 throws HibernateException 
Track 29 1 
20 Query query = session. getNamedguery ("com.oréeilly.hh.artiste 
31 query.setstring (“name”, name); 
32 Artist found = (Artist) query.uniqueResult (); 
33 if (found = == Bull 而 而 & create) i 


图 12-4 交叉 引用 的 HTML 源 代码 


在 查看 代码 时 ，JXR 报 告 很 有 用 。 还 有 很 多 其 他 报告 可 以 使 用 ， 例 
如 ， 用 Clover 报 告 测试 的 覆盖 度 ， 以 及 JDepend 报 告 、DocBook、PDF 
生成 等 。 


这 里 我 们 不 打算 详细 介绍 Maven 的 工作 原理 ， 只 是 进行 了 编译 、 构 
建 数据 库 、 测 试 、 打 包 、 对 某 个 简单 的 示例 代码 进行 文档 化 。 在 下 一 
市 中 ， 我 们 将 看 看 让 这 一 切 都 成 为 可 能 的 文件 ，pom.xml。 这 样 ， 对 
Maven 的 配置 和 定制 ， 你 才 会 有 一 定 的 感觉 


Maven 项 目 对 象 模型 


人 


项 目 对 象 模 型 (Project Object Model) 是 Maven 的 核心 ， 它 是 运行 
Maven 惟 一 需要 的 配置 文件 。 每 个 Maven 项 目 都 有 一 个 pom.xml 文 件 ， 
它 描 述 了 项 目的 属性 和 依赖 关系 ， 以 及 任何 自 定 义 的 构建 配置 。 例 12- 
3 演示 了 支持 前 面 项 目 构 建 的 pom.xml 文 件 内 容 。 


例 12-3: Maven 项 目 对 象 模型 (POM) 


<project xmlns="http://maven.apache.org/POM/4.0.0"@ 
xmlns: xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupiId>com.oreilly.hh</groupId>@ 
<artifactId>hib-dev-chi2</artifactId> 
<version>2.0-SNAPSHOT </version> 

<name>Harnessing Hibernate: Chapter Twelve: Maven</name> 
<packaging> jar </packaging>® 

<dependencies>® 

< dependency > 

<groupId> junit </groupId> 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 

<scope>test </scope> 

</dependency > 

<dependency> 

<groupId>hsqldb</groupiId> 
<artifactId>hsqldb</artifactId> 
<version>1.8.0.7</version> 

</dependency > 

< dependency > 

<groupId>org.hibernate</groupId> 
<artifactId>hibernate</artifactId> 
<version>3.2.5.ga</version> 

<exclusions> 


<exclusion> 
<groupId>javax.transaction</groupId> 
<artifactId>jta</artifactId> 

</exclusion> 

</exclusions > 

</dependency > 

< dependency > 
<groupId>org.apache.geronimo.specs</groupId> 
<artifactId>geronimo-jta_1.1_spec</artifactId> 
<version>1.1</version> 

</dependency > 

< dependency > 

<groupId>1log4j </groupiId> 

<artifactId>1log4j </artifactId> 
<version>1.2.14</version> 

</dependency > 

< dependency > 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-annotations</artifactId> 
<version>3.3.0.ga</version> 

</dependency > 

< dependency > 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-commons-annotations</artifactId> 
<version>3.3.0.ga</version> 

</dependency > 

</dependencies > 

<build> 

<extensions>® 

<extension> 

<groupId>hsqldb</groupiId> 
<artifactId>hsqldb</artifactId> 
<version>1.8.0.7</version> 

</extension> 

<extension> 

<groupId>1log4j </groupId> 
<artifactId>1log4j</artifactId> 
<version>1.2.14</version> 

</extension> 

</extensions > 

<plugins> 

<plugin>® 
<groupId>org.apache.maven. plugins </groupId> 
<artifactId>maven-compiler -plugin</artifactId> 
<configuration> 

<source>1.5</source> 

<target >1.5</target> 

</configuration> 


</plugin> 

<plugin>@ 
<groupId>org.codehaus.mojo</groupId> 
<artifactId>hibernate3-maven-plugin</artifactId> 
<version>2.0</version> 

<executions> 

<execution> 

<id>generate-ddl</id> 

<phase >process-classes</phase> 

<goals> 

<goal>hbm2dd1</goal> 

</goals> 

</execution> 

</executions > 

</plugin> 

</plugins > 

</build> 

<reporting>® 

<plugins> 

<plugin> 
<artifactId>maven-javadoc-plugin</artifactId> 
</plugin> 

<plugin> 
<groupId>org.codehaus.mojo</groupId> 
<artifactId>jxr-maven-plugin</artifactId> 
</plugin> 

<plugin> 
<artifactId>maven-surefire-report-plugin</artifactId> 
</plugin> 

</plugins > 

</reporting> 

</project > 


这 束 是 我 们 编译 、 测 试 、 生 成 Web 网 站 时 需要 提供 的 所 有 配置 : 


@@ 文 档 元 素 是 project。 我 们 采用 xsi: schemaLocation 来 定义 Maven 
POM 第 4 版 的 XML Schema。 如 有 果 你 想 全 面 地 了 解 引用 的 这 个 Schema， 
可 以 把 它 加 载 到 类 似 XMLSpy 的 工具 中 ， 这 个 Schema 的 文档 注释 一 目 
了 然 。 


@ 接 着 ， 我 们 定义 了 一 组 每 个 Maven 项 目 都 可 以 公用 的 标识 符 : 
groupId、artifactId 以 及 version。 这 三 个 属性 相当 于 Maven 项 目的 惟 
一 “坐标 ”。 在 这 个 POM 的 全 部 内 容 中 ， 你 会 注意 到 各 种 依赖 、 扩 展 以 
及 插件 都 引用 了 这 三 个 属性 中 的 一 个 或 多 个 。 


四 这 个 项 目的 packaging 是 jar。 将 打包 格式 设置 为 jar， 就 告诉 
Maven 这 个 项 目的 构建 结果 应 该 生成 一 个 JAR 文 件 。Maven 文 持 一 套 预 
定 的 打包 格式 ， 例 如 pom、jar 以 及 war。 如 果 在 POM 中 没有 声明 
packaging 元 素 ， 其 默认 值 就 是 jar ° 


@dependencies 元 系 告 诉 Maven 这 个 项 目 震 要 依赖 什么 样 的 外 部 库 
文件 。 Maven POM 中 的 dependencies 与 我 们 一 直 在 用 的 Maven Ant Task 
中 的 dependencies 完 全 一 样 。 如 采 将 这 个 pom.xml 中 的 dependencies 的 内 
容 与 build.xml 的 对 应 内 容 进行 比较 ， 你 会 发 现 这 里 包括 的 依赖 与 第 7 章 
的 build.xml 中 的 依赖 是 一 样 的 ，JUnit、HSQLDB、Hibernate (JF 


JTA) 、Apache Geronimo 中 的 JTA 以 及 Hibernate Annotations。 


@build 元 素 是 我 们 定义 构建 的 地 方 。 在 这 个 地 方 我 们 能 够 为 插件 
配置 自 定 义 的 行为 ， 以 及 配置 Maven 默 认 安装 中 可 能 没有 提供 的 插 
件 。 因 为 准备 将 Hibernate3 搬 件 配置 为 使 用 HSQLDB， 所 以 在 build 元 素 
下 的 extensions 添 加 了 hsqldb 和 1log4j 库 。extension 元 素 的 内 容 是 任何 在 
插件 执行 期 间 需 要 在 类 路 径 上 出 现 的 依赖 的 groupId、artifactId 以 及 


version 值 。 


@ 第 一 个 plugin 元 聚 是 配置 编译 器 插件 ， 让 它 使 用 兼容 Java 5 的 源 
代码 和 目标 文件 。 


@ 这 里 我 们 对 Codehaus (''!) 的 Mojo 项 目 中 的 Hibernate3 Maven 

插件 进行 配置 。 在 编写 本 书 时 ，Hibernate3 插 件 的 最 新 发 行 版 本 是 
这 一 插件 配置 标明 了 hibernate.cfg.xml 的 公共 位 置 ， 也 添加 了 一 个 

属性 来 告诉 hbm2ddl: 当 生 成 数据 库 模式 时 不 要 删除 已 有 的 数据 库 。 
基于 Ant 的 例子 会 在 编译 完成 之 后 的 构建 期 间 执行 hbbm2ddl 目 标 ， 而 
POM 则 是 将 hbm2ddl 放 在 Maven 的 process-classes 阶 段 执行 。 我 们 将 在 
本 章 后 面 的 *Maven 构 建 的 生命 周期 ”一 节 中 再 详细 介绍 Maven 构 建生 命 
周期 中 的 各 个 阶段 。 


@ 最 后 ，reporting 区 段 配 置 在 网 站 生成 阶段 要 执行 的 报告 
(report) 生成 器 。 用 于 生成 报告 的 Maven 插 件 有 一 个 report 目 标 ， 在 
网 站 生成 过 程 中 会 调用 这 个 目标 。 为 了 包括 报告 ， 必 须要 在 reporting 
元 素 下 包括 相应 的 插件 。 


注意 这 种 pom.xml 文 件 和 其 他 章节 的 build.xml 文 件 的 区 别 。 在 
build.xml 中 ， 我 们 需要 明确 地 告诉 Ant 要 做 什么 ， 在 哪 和 什么 时 间 进 行 
操作 ， 怎 么 保存 结果 。 在 Maven 中 ， 我 们 只 需要 指出 依赖 和 说 明 需 要 
执行 的 目的 。Maven 插 件 知道 应 该 怎么 做 ， 负 责编 译 的 插件 会 查找 
src/main/java 目 录 下 的 源 文件 和 src/test/java 目 录 下 的 测试 代码 。 
Hibernate3 插 件 “ 知 道 ” 我 们 的 hibernate.cfg.xml 文 件 应 该 放 在 


src/main/resources 目 录 中 。 如 采 我 们 将 hibernate.cfg.xml 文 件 保存 到 不 
同 的 位 置 ， 就 得 告诉 插件 这 一 情况 ， 但 是 ， 为 什么 要 不 辞 辛 昔 地 修改 
默认 的 约定 ， 又 有 什么 意义 呢 ? 本 章 稍 后 会 在 12.8 节 仔细 看 看 
Hibernate3 插 件 。 


父 / 子 项 目 对 象 模型 


本 章 的 示例 使 用 的 是 一 个 单独 pom.xml， 以 简化 对 Maven 的 介绍 ， 
而 其 他 各 章 的 示例 采用 的 是 所 谓 的 多 模块 (multi-module) Maven 项 
目 ， 在 这 种 模型 中 ， 每 一 个 子 模块 (submodule) 需要 依赖 一 个 父 模 
块 。 我 们 以 第 7 章 为 例 ， 在 ch07 目 录 中 ， 你 可 以 找到 一 个 pom.xml 文 
件 ， 其 内 容 如 例 12-4 所 示 。 这 里 需要 注意 的 第 一 件 事 束 是 这 个 文件 这 
么 小 ， 它 的 所 有 依赖 是 在 哪 定义 的 ? 


例 12-4: 第 7 章 的 pom.xml 文 件 


<?xml version="1.0"encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins: xsi="http://www.w3.org/2001/XMLSchema- instance" 
xsi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 

<parent> 

<groupiId>com.oreilly.hh</groupId>@® 
<artifactId>hib-dev-parent</artifactId> 
<version>2.0-SNAPSHOT </version> 

</parent > 

<modelVersion>4.0.0</modelVersion> 
<artifactId>hib-dev-ch7</artifactId>@ 
<packaging> jar </packaging>® 

<name>Harnessing Hibernate: Chapter Seven</name> 


<version>2.0-SNAPSHOT </version> 
<build> 

<plugins> 

<plugin> 
<groupId>org.codehaus.mojo</groupId> 
<artifactId>hibernate3-maven-plugin</artifactId> 
<version>2.0-alpha-3-SNAPSHOT </version> 
<executions> 

<execution> 

<id>generate-ddl</id> 

<phase >process-classes</phase> 

<goals> 

<goal>hbm2dd1</goal> 

</goals> 

</execution> 

</executions > 

<configuration> 

<components> 

<component > 

< name >hbm2dd1< /name>® 
<implementation>annotationconfiguration</implementation> 
</component > 

</components > 

</configuration> 

</plugin> 

</plugins > 

</build> 

<dependencies>® 

<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-annotations</artifactId> 
<version>3.3.0.ga</version> 
</dependency > 

<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-commons-annotations</artifactId> 
<version>3.3.0.ga</version> 
</dependency > 

</dependencies > 

</project > 

</project > 


这 个 pom.xml 从 表面 上 看 起 来 相当 简单 ， 因 为 它 的 配置 大 部 分 都 
继承 目 父 项 目的 POM 〈 稍 后 再 介绍 ) 。 我 们 先 来 看 看 这 个 简单 的 POM 


的 内 容 : 


@ 我 们 先 把 这 个 项 目 链接 到 一 个 父 项 目 上 ， 由 groupId 、artifactId 
以 及 version 这 三 个 属性 来 定义 该 父 项 目 。 在 Maven 中 定义 的 所 有 项 目 
都 具有 这 三 个 属性 ， 它 们 是 一 个 Maven 项 目的 惟一 “坐标 *。 父 项 目 将 
在 下 一 个 例子 中 再 介绍 ， 不 过 ， 现 在 你 只 需要 知道 
examples/ch07/pom.xml 继 承 了 examples/pom.xml 中 定义 的 所 有 属性 就 可 
以 了 。 


@ 我 们 将 artifactId 属 性 定义 为 hib-dev-ch07。 此 处 改写 了 父 POM 中 
的 相应 属性 ， 为 这 个 项 目 提 供 了 一 个 惟一 的 值 。 如 前 所 述 ， 所 有 项 目 
必须 具有 一 个 惟一 的 由 groupId 、artifactId 以 及 version 构 成 的 组 合 ， 这 
样 可 以 确保 例 ch07 具 有 一 个 惟一 的 artifactId。 注 意 ， 这 个 pom.xml 并 没 
有 定义 groupId， 因 为 它 会 继承 父 pom.xml 中 的 groupId 。 


目 接 下 来 ， 我 们 改写 了 这 个 项 目的 POM 的 packaging 属 性 。Maven 
有 一 套 预 定义 的 打包 格式 ， 例 如 pom、jar 以 及 war。 将 例 ch07 的 打包 格 
式 修改 为 jar， 就 告诉 Maven: 这 个 项 目 期 望 它 的 构建 结果 是 生成 JAR 
文件 。 


@ 这 一 行 是 在 配置 Maven Hibernate3 插 件 ， 类 似 于 我 们 在 本 章 示 例 
目录 中 进行 过 的 处 理 。 这 里 不 同 的 是 ， 我 们 正在 配置 Hibernate3 插 件 ， 
让 它 使 用 基于 标注 的 配置 方式 ， 第 7 章 介 绍 的 全 部 是 有 关 标 注 的 内 容 。 


这 一 配置 将 会 从 一 套 保 存在 src/main/java 中 的 带 有 标注 的 模型 类 中 抽取 
Hibernate 的 映射 信息 。Maven 先 将 Java 源 文件 编译 到 target/classes 目 录 
中 ，Maven Hibernate3 插 件 再 扫描 生成 的 字 市 码 文 件 ， 查 找 其 中 的 
@Entity 标 注 。 最 后 ，hbm2ddl 目 标 再 用 这 些 轴 射 信息 生成 HSQLDB 数 
据 库 。 


介 我 们 声明 这 个 子 模块 的 依赖 为 Hibernate Annotations 和 Hibernate 
Commons Annotations。 这 些 新 的 依赖 会 添加 到 父 项 目 定义 的 任何 依赖 
当中 。 


第 7 章 的 POM 引 用 了 一 个 父 POM， 那 这 个 父 POM 是 在 哪 定 义 的 ? 
转 到 ch07 的 父 目录 ， 你 会 看 到 也 有 一 个 pom.xml 文 件 (文件 体积 要 大 很 
Z) 。 在 这 个 文件 中 就 定义 了 供 其 他 各 章 示 例 的 POM 所 共享 的 所 有 属 
性 。 我 们 来 看 看 这 个 父 pom.xml， 其 内 容 如 例 12-5 所 示 。 


例 12-5: 共享 的 顶级 pom.xml 


<?xml version="1.0"encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins: xsi="http://www.w3.org/2001/XMLSchema-instance" 
XSi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupiId>com.oreilly.hh</groupiId>@® 
<artifactId>hib-dev-parent</artifactId> 
<packaging> pom</packaging>@® 

<name>Harnessing Hibernate: Parent Project </name> 
<version>2.0-SNAPSHOT </version> 

<modules> © 

< module > ch01< /module> 


<module>ch02< /module> 

<module>ch03< /module> 

<module>ch04< /module> 

<module>ch05< /module> 

<module>ch06< /module> 

<module>ch07< /module> 

<module>ch08< /module> 

<module>ch09< /module> 

<module>chi0< /module> 

<module>chi1< /module> 

<module>chi2< /module> 

<module>chi3< /module> 

<module>chi4< /module> 

</modules > 

<build> 

<extensions>® 

<extension> 
<groupId>hsqldb</groupiId> 
<artifactId>hsqldb</artifactId> 
<version>1.8.0.7</version> 
</extension> 

<extension> 

<groupId>1log4j </groupiId> 
<artifactId>1log4j</artifactId> 
<version>1.2.14</version> 
</extension> 

</extensions > 

<resources> 

<resource> 
<directory>src</directory>® 
</resource> 

</resources> 
<sourceDirectory>src</sourceDirectory > 
<plugins> 

<plugin> 

<groupId>org.apache.maven. plugins </groupId> 
<artifactId>maven-compiler-plugin</artifactId>@ 
<configuration> 
<source>1.5</source> 

<target >1.5</target> 
</configuration> 

</plugin> 

<plugin> 
<groupId>org.codehaus.mojo</groupId> 
<artifactId>hibernate3-maven-plugin</artifactId>@ 
<version>2.0</version> 
<configuration> 

<components > 


<component > 

< name > hbm2java< /name > 
<implementation>configuration</implementation> 
</component > 

</components > 
<componentProperties > 
<drop>false</drop> 
<configurationfile> 
src/hibernate.cfg. xml 
</configurationfile> 
<jdk5>true</jdk5> 
</componentProperties > 
</configuration> 

</plugin> 

</plugins > 

</build> 

<dependencies>® 

< dependency > 
<groupId>hsqldb</groupId> 
<artifactIid>hsqldb</artifactId> 
<version>1.8.0.7</version> 
</dependency> 

<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate</artifactId> 
<version>3.2.5.ga</version> 
<exclusions> 

<exclusion> 
<groupId>javax.transaction</groupId> 
<artifactId>jta</artifactId> 
</exclusion> 

</exclusions > 

</dependency > 

< dependency > 
<groupId>org.apache.geronimo.specs</groupId> 
<artifactId>geronimo-jta_1.1_spec</artifactId> 
<version>1.1</version> 
</dependency > 

< dependency > 
<groupId>10g4j</groupId> 
<artifactId>1log4j </artifactId> 
<version>1.2.14</version> 
</dependency > 

</dependencies > 

</project> 


该 父 POM 包 含 的 信息 要 比 其 子 POM 多 很 多 。 它 定义 了 所 有 公共 的 
依赖 、 目 录 设 置 以 及 每 草 示 例 可 以 共 侍 的 插件 配置 。 再 一 次 ， 我 们 一 


部 分 一 部 分 地 看 看 这 个 从 POM: 


@groupId 元 素 用 于 定义 供 所 有 子 项 目 共 至 的 group 标 识 从 。 
groupId 的 标准 命名 习惯 是 使 用 一 个 反 疝 的 完全 限定 的 域名 UKE AY 
域名 ， 或 是 与 项 目 相关 的 域名 ) ， 其 后 再 跟 上 特定 领域 的 标识 符 。 如 
果 你 想 在 Maven 仓 库 中 发 布 自己 的 artifact， 这 样 的 命名 规则 就 特别 重 
要 。 


@ 在 人 多 POM 中 ， 将 packaging 设 置 为 pom。 这 意味 着 这 个 项 目的 存 
在 只 是 为 了 提供 POM， 这 个 项 目 不 会 提供 任何 JAR 文 件 或 WAR 文 件 ， 


它 只 提供 POM 。 


日 父 POM 定 义 了 modules 列 表 。 这 部 分 列 出 了 每 章 的 示例 目录 ， 
个 目录 中 都 包含 一 个 pom.xml 文 件 。 如 琳 你 查看 这 些 目 隶 ， 束 会 发 现 
其 中 的 每 个 pom.xml 文 件 都 引用 了 这 个 父 POM。 在 父 POM 中 指定 所 有 
的 模块 ， 就 可 以 让 我 们 能 够 一 次 性 地 构建 所 有 章节 (或 模块 ) 的 项 
H o 


@extensions 元 素 用 于 配置 各 插件 使 用 的 类 路 径 。 父 pom.xml 定 义 
的 extensions 与 例 12-3 中 的 相同 。 


@ 此 处 ， 我 们 正在 定制 项 目的 类 路 径 资源 (resource) 的 位 置 。 在 
通常 的 Maven 项 目 中 ， 我 们 不 需要 定义 这 个 属性 ， 而 是 依赖 其 默认 值 
${basedir}/src/main/resources (${basedir} 是 包含 pom.xml 文 件 的 目 
SK) 。 在 本 书 中 (因为 这 是 本 关于 Hibernate 的 书 ， 而 不 是 专门 介绍 
Maven 的 ) ， 我 们 要 将 Maven 构 建 应 用 到 现 有 的 章节 示例 上 ， 所 以 需 
要 将 类 路 径 资源 定义 为 src。 除 了 定义 类 路 径 资源 的 位 置 ， 我 们 也 需要 
定义 源 代码 的 位 置 。 在 标准 的 Maven 项 目 中 ， 我 们 应 该 不 用 在 pom.xml 
中 定义 这 个 属性 ， 而 是 使 用 默认 值 ${basedir}/src/mainm/java ° 


@ 这 一 部 分 用 于 将 编译 需 插 件 配 置 为 Java 5 目标 。 


@Hibernate3 插 件 是 通过 儿 个 全 局 选项 来 配置 的 。 将 drop 设 置 为 
false， 会 让 hbm2ddl 目 标 不 删除 已 有 的 数据 库 。 将 jdk5 设 置 为 tue， 会 
让 hbm2java 目 标 生成 支持 Java 5 泛 型 的 模型 类 属性 (例如 使 用 Set < 
Album > ， 而 不 只 是 Set) 。 我 们 也 可 以 用 configurationFile 来 配置 
hibernate.cfg.xml 的 默认 位 置 (如 果 该 文件 不 在 Maven 的 预想 位 置 
E) 。hbm2java 的 component 项 中 ， 将 implementation 设 置 为 
configuration， 这 意味 着 默认 行为 将 是 扫 搬 主 资 源 目录 ， 以 查 
找 .hbm.xml 映 射 文件 。 我 们 在 例 12-4 中 看 到 过 ，ch07 的 pom.xml 改 写 了 
hbm2ddl 组 件 的 这 一 配置 ， 使 其 采用 标注 来 作为 Hibermmate 的 配置 方式 。 


@ 最 后 ， 顶 级 的 POM 定 义 了 一 组 供 所 有 章节 的 例子 共享 的 依赖 。 
它们 是 HSQLDB 1.8.0.7、Hibernate 3.2.5.ga、Apache Geronimo 项 目的 


JIA 库 以 及 Log4j 1.2.14。 可 以 比较 一 下 这 个 dependencies 元 系 的 内 容 与 
任何 一 章 的 build.xml 脚 本 中 Maven Ant Task 的 配置 。 


以 运行 ch07 目 录 中 的 示例 来 做 为 例子 。 首 先 ， 删 除 data 目 录 (如 
果 存 在 ) ， 再 运行 mvn install。 这 将 编译 源 代码 、 按 模型 中 的 标注 来 生 
成 数据 库 模 式 、 将 ch07 中 的 示例 打包 到 一 个 JAR 文 件 中 。 在 运行 构建 
过 程 以 后 ， 就 可 以 像 原 来 用 Ant 那 样 来 运行 CreateTest、QueryTest 以 及 
AlbumTest。 这 些 过 程 如 例 12-6 所 示 。 


例 12-6: 使 用 Maven 来 运行 第 7 章 的 测试 


~/examples/chO7$mvn exec: java- 
Dexec.mainClass=com.oreilly.hh.CreateTest 

[INFO]Scanning for projects... 

[INFO]Searching repository for plugin with prefix: 'exec'. 

[INFO]---------------------------------------------------------- 


[INFO]Building Harnessing Hibernate: Chapter Seven 
[INFO]task-segment: [exec: java] 
[INFO]---------------------------------------------------------- 


[INFO]Preparing exec: java 

[INFO]No goals needed for project-skipping 

[INFO][exec: java] 

~/examples/chO7$mvn exec: java- 
Dexec.mainClass=com.oreilly.hh.QueryTest 

[INFO]Scanning for projects... 

[INFO]Searching repository for plugin with prefix: 'exec'. 

[INFO] - -------- 2-9-2 nnn nnn nn nn en nn ee eee eee eens 


[INFO]Building Harnessing Hibernate: Chapter Seven 
[INFO]task-segment: [exec: java] 
[INFO]---------------------------------------------------------- 


[INFO]Preparing exec: java 
[INFO]No goals needed for project-skipping 
[INFO][exec: java] 
Track: "Russian Trance", 00: 03: 30 
Track: "Video Killed the Radio Star", 00: 03: 49 
Track: "Test Tone 1", 00: 00: 10 
~/examples/ch07$mvn exec: java- 
Dexec.mainClass=com.oreilly.hh.AlbumTest 
(output omitted) 


以 上 我 们 使 用 了 一 个 通常 不 附加 到 Maven 生 命 周期 中 的 插件 构建 
目标 一 exec: java。 这 个 目标 将 接受 从 命令 行 传递 的 exec.mainClass 参 


数 ， 并 执行 给 定 类 中 的 main () 方法 。 


[1] http://mojo.codehaus.org/maven-hibernate3/hibernate3-maven-plugin/. 


Maven 构 建 的 生命 周期 


在 本 章 的 前 面 几 方 中 我 们 谈 到 了 生命 周期 ， 所 以 到 目前 为 止 ， 你 
应 该 至 少 掌握 Maven 的 构建 生命 周期 中 包含 编译 、 测 试 、 打 包 、 和 安装 
阶段 。 在 例 12-3 中 ， 我 们 将 hbm2ddl 目 标 附 加 到 类 人 处理 (process- 
classes) 阶段 ， 同 时 指出 这 个 阶段 紧 跟 在 编译 阶段 之 后 。 如 果 所 有 这 
些 看 起 来 让 你 感到 一 头 雾 水 ， 不 要 担心 ， 我 们 将 会 简单 地 解释 生命 周 
期 中 的 各 个 阶段 和 它们 的 执行 顺序 。 当 从 命令 行 运行 Maven 时 ， 需 要 
选择 指定 某 个 阶段 的 名 称 ， 或 者 显 式 地 执行 一 个 插件 目标 。 当 指定 了 
一 个 阶段 时 ，Maven 将 执行 它 的 生命 周期 中 直到 该 阶段 之 前 的 所 有 阶 
Be (包括 这 个 指定 的 阶段 ，。 在 Maven 处 理 其 构建 生命 周期 时 ， 它 会 
触发 附加 到 当前 阶段 上 的 插件 的 目标 。 男 一 方面 ， 如 果 显 式 地 请 求 一 
个 插件 目标 ， 则 Maven 将 只 执行 那个 单独 的 插件 目标 。 


以 下 列举 了 Maven 的 所 有 生命 周期 阶段 ， 而 且 按 它们 发 生 的 顺序 
进行 排序 。 对 于 我 们 的 示例 来 说 比较 重要 的 阶段 ， 会 解释 得 细致 些 ; 
而 对 于 其 他 不 重要 的 阶段 ， 则 将 它们 组 合 起 来 以 节省 空间 : 


validate (验证 ) 


验证 POM ° 


generate-sources (生成 源 代码 ) 


生成 任何 源 代码 。Hibernate3 搬 件 有 一 个 hbbm2java 目 标 ， 可 以 根据 
基于 XML 的 映射 而 生成 Java 源 代码 《就 像 我 们 在 前 几 章 中 做 的 那 
样 ) 。 如 果 我 们 想 为 映射 生成 Java 源 代码 ， 则 可 以 将 hbm2java 附 加 到 


这 个 阶段 。 


process-sources ` generate-resources ` process-resources (处 理 源 文 


件 、 生 成 资源 、 处 理 资源 ) 


除了 生成 源 代 码 ， 还 需要 处 理 源 代码 生成 的 输出 、 生 成 资源 文件 
(例如 properties 文 件 、 图 片 、 声 音 以 及 程序 包 的 其 他 非 代码 元 素 ) 以 
及 处 理 资 源 文件 。 


compile (编译 ) 


编译 如 插件 运行 编译 目标 ， 对 编译 源 代码 根 目录 下 的 所 有 源 代码 
进行 编译 。 插 件 可 以 在 编译 源 代码 根 目 录 中 添加 新 的 目录 ， 例 如 
Hibernate3 插 件 的 hbbm2java 目 标 束 会 根据 .hbbm.xml 文 件 生成 源 代码 ， 并 
将 生成 的 源 代码 放 到 target/generated-source 目 录 中 。Hibernate3 插 件 接 
着 再 将 target/generated-source 目 录 深 加 到 编译 源 代码 根 目录 ， 以 便 在 编 
译 时 可 以 包含 新 生成 的 文件 。 


process-classes (后 处 理 编译 生成 的 类 ) 


该 阶段 对 编译 的 结果 进行 后 期 处 理 (post-processes) 。 我 们 已 经 
将 hbbm2ddl 目 标 挂 到 了 类 的 后 期 处 理 任务 上 ， 因 为 需要 对 hbm2ddl 任 务 
进行 配置 ， 才 可 以 利用 对 象 模型 中 的 标注 ， 将 它们 编译 为 模型 类 文 
件 。Hibernate3 插 件 被 配置 为 需要 对 生成 的 字 节 码 进行 搜索 ， 以 查找 出 
现 的 "@Entity" 标 注 。 因 为 只 有 先 编译 好 了 模型 类 ， 才 可 以 进行 这 样 的 
扫描 ， 所 以 我 们 将 这 个 目标 挂 到 了 编译 阶段 之 后 的 处 理 阶 段 。 


generate-test-sources ` process-test-sources ` generate-test- 


resources 、 process-test-resources 


这 几 个 阶段 与 从 generate-sources 到 generate-resources 的 几 个 阶段 类 


似 ， 可 以 生成 单元 测试 及 其 需要 的 任何 资源 。 


test-compile (编译 测试 源码 至 测试 目标 目录 ) 


使 用 testCompile 目 标 ， 再 次 调用 Compiler 皇 件 来 编译 测试 源 代 
码 。 对 于 我 们 的 示例 来 说 ， 这 个 它 只 是 编译 src/test/java 目 杂 中 的 一 个 
简单 的 类 。testCompile 目 标 会 编译 测试 源 代码 根 目 隶 中 的 所 有 源 代 
码 。 再 说 一 次 ， 这 并 不 是 简单 地 对 src/tesUjava 中 的 所 有 代码 进行 编 
译 ， 因 为 在 前 面 4 个 生命 周期 阶段 中 ， 揪 件 都 有 机 会 生成 单元 测试 的 源 
代码 (在 测试 源 代码 根 目 录 中 添加 目录 ) 。 


test (测试 ) 


Surefire 插 件 扫描 testr-compile 阶 段 生 成 的 继承 目 JUnit 的 TestCase 的 
类 ， 并 使 用 JUnit 执 行 这 些 单元 测试 (也 可 以 运行 TestrNG 测 试 ) 。 


prepare-package (准备 打包 ) 


在 真正 将 项 目 打包 以 前 ， 执 行 一 些 准备 处 理 。 提 供与 此 相关 的 目 
标 。 


package (打包 ) 


对 于 我 们 的 示例 项 目 来 说 ， 最 终 只 需要 生成 一 个 JAR 文 件 。jar 打 
包 的 默认 行为 殉 是 创建 一 个 名 为 ${artifactId}-${version} jar 的 文件 。 如 
果 需 要 的 话 ， 可 以 目 定义 这 个 文件 名 称 。 不 过 ， 如 宁可 能 的 话 ， 尽 可 
能 避免 对 Maven 进 行 定 制 ， 将 是 更 好 的 做 法 。 


pre-integration-test ` integration-test ` post-integration-test ( 预 集成 


测试 、 集 成 测试 、 集 成 测试 后 期 ) 


单元 测试 通 间 不 需要 连接 到 数据 库 ， 事 实 上 ， 在 单元 测试 中 连接 
数据 库 的 做 法 也 让 人 感觉 有 些 古 怪 (我 将 其 称 为 功能 或 集成 测试 ) 
如 有 果 你 需要 执行 一 系列 集成 测试 ， 可 以 使 用 这 3 个 阶段 来 定义 相关 的 目 
标 。 


verify (验证 ) 


可 以 为 验证 阶段 定义 一 些 用 于 检查 生成 的 输出 是 否 符合 质量 规范 
的 目标 。 


install (安装 ) 


在 我 们 的 项 目 中 ， 安 装 阶段 只 是 将 生成 的 artifact 复 制 到 
~/.m2/repository/${groupld}/${artifactld}/${version}/${artifactIld}-${vers 
ion}. .jar 文件 中 。 如 果 你 正在 创建 一 套 复 杂 的 交叉 依赖 的 项 目 (也 就 是 
说 ， 项 目 A 定 义 了 对 一 个 具体 的 库 的 依赖 ， 而 项 目 B 也 需要 依赖 这 个 
库 ) ， 那 么 项 目 B 就 可 以 用 groupId 、artifactId 以 及 version (版 本 ) 来 定 
义 一 个 对 项 目 A 的 依赖 ， 当 Maven 在 构建 项 目 B 时 ， 会 党 试 在 本 地 仓库 
中 解析 项 目 A 的 artifact。 通 过 将 制品 也 安装 到 本 地 仓库 中 ，install 阶 段 
就 可 以 支持 这 一 功能 。 


deploy (Hh) 


用 于 将 项 目的 制品 、 网 站 、 报 告发 布 到 一 个 外 部 的 仓库 中 。 项 目 
也 可 以 利用 这 个 阶段 将 各 种 制品 发 布 到 一 个 远程 Maven 人 仓库。 远程 
Maven 仓 库 可 以 是 公共 的 或 秘 有 的 Maven 仓 库 ， 或 者 是 企业 内 部 的 


Maven 仓 库 。 


使 用 Maven Hibernate3 皇 件 


本 章 使 用 的 是 来 自 Mojo 项 目 中 的 Maven Hibermate3 插 件 (01), 
Mojo 是 Codehaus 上 的 一 个 项 目 ， 它 为 开发 Maven 揪 件 提供 一 个 Apache 
Software Foundation (ASF) 以 外 的 空间 。 不 像 ASF 那 样 有 很 多 规则 

只 要 对 一 些 Maven 插 件 感 兴趣 就 可 以 开始 为 Mojo 做 贡献 ， 这 比 ASF 上 
Maven 项 目 中 的 那些 插件 的 开发 要 更 容易 些 。 将 Mojo 放 在 Codehaus 上 
的 另 一 个 原因 是 ， 一 些 Maven 插 件 使 用 的 技术 的 许可 协议 与 Apache 
Software License 不 兼容 。Mojo 的 插件 可 以 采用 GPL 协议 ， 而 且 可 以 按 
非 Apache Software License 发 布 。 而 在 Apache Software Foundation 中 , 
所 有 东西 的 发 行 都 需要 采用 Apache Software License。 


为 了 使 用 Maven Hibernate3 插 件 ， 所 有 你 需要 做 的 就 是 将 例 12-7 演 
示 的 plug-ipn 元 素 包括 到 项 目的 pom.xml 文 件 中 。 


例 12-7: 使 用 Maven Hibernate3 i (+ 


<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmins: xsi="http://www.w3.org/2001/XMLSchema- instance" 
XSi: schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 

nid pom content skipped... 

<build> 

<plugins > 

<plugin> 

<groupId>org.codehaus .mojo</groupId> 
<artifactId>hibernate3-maven-plugin</artifactId> 
<version>2.0</version> 


</plugin> 
</plugins > 

</build> 

sae pom content skipped 
</project> 


Hibernate3 插 件 定义 了 以 下 构建 目标 《也 称 为 配置 目的 的 组 件 ) : 


hibernate3: hbm2cfgxml 


基于 现 有 的 数据 库 模 式 而 生成 一 个 hibernate.cfg.xml 文 件 。 可 以 使 
用 这 个 目标 为 已 有 的 数据 库 构 建 相 应 的 Hibernate 配 置 。 


hibernate3:hbm2ddl 


基于 现 有 的 Hibemate 映 射 而 生成 相应 的 SQL DDL (数据 库 定义 语 
言 ) (使 用 标注 或 .hbm.xml 文 件 ) 。 在 我 们 的 例子 中 ， 它 生成 的 是 一 个 
HSQLDB 数 据 库 。 


hibernate3:hbm2doc 


生成 一 个 HTML 报 告 ， 用 于 描述 Object Model (XS RRA) 、 数 据 
库 模 式 以 及 如 何 将 二 者 关联 起 来 。 生 成 的 报告 的 界面 风格 与 JavaDoc 类 
似 。 


hibernate3:hbm2hbmxml 


根据 现 有 的 数据 库 模 式 而 生成 .hbm.xml 映 射 文档 。 如 果 你 有 一 套数 
据 库 表 ， 就 可 以 用 这 个 任务 来 生成 映射 文件 ， 再 用 下 一 个 构建 目标 来 
生成 Java 类 。 


hibernate3:hbm2java 


根据 Hibernate 映 射 而 生成 Java 源 代码 。 这 个 构建 目标 可 以 
从 .hbm.xml 文 件 生成 Java 代 码 ， 或 者 生成 与 现 有 数据 库 中 的 数据 表 对 应 
的 Java 类 ° 


有 关 Maven 插 件 的 更 多 信息 ， 可 以 参阅 Maven 网 站 (1) 的 在 线 文 
档 ， 有 关 Hibernate3 Maven 插 件 的 信息 ， 还 可 以 看 看 Mojo 项 目 (3 
) 


除了 Apache Maven 发 布 的 核心 插件 以 外 ， 人 们 还 需要 为 Maven 编 写 
目 己 的 捅 件 ，Mojo 这 个 项 目 束 是 为 此 服务 的 。 如 有 果 你 有 了 天 于 Maven 
揪 件 的 好 想法 ， 应 该 考虑 参与 到 Mojo 项 目 之 中 。 


配置 Hibernate3 插 件 


Maven Hibernate3 插 件 提供 了 许多 配置 点 。 以 下 列举 了 其 中 一 些 重 
要 的 配置 选项 : 


propertyfile 


如 采 在 Hibernate 配 置 文件 中 没有 指定 JDBC 连 接 信息 ， 也 可 以 在 
database.properties 文 件 中 指定 JDBC 连 接 参 数 ， 默 认 使 用 


src/main/resources/database.properties ° 


configurationfile 
Hibernatefic EX ° ERE HA src/main/resources/hibernate.cfg.xml ° 
jdk5 


生成 Java 5 源 代码 。 当 生成 与 Hibernate 映 射 匹 配 的 Java 源 代码 时 ， 
支持 使 用 泛 型 和 枚 举 类 型 。 默 认 值 是 false 。 


ejb3 

生成 市 有 ejb3 标 注 的 源 代 码 ， 默 认 值 是 false。 

drop 

在 执行 hbbm2ddl 前 ， 先 删除 数据 库 表 。 默 认 值 是 false。 
Create 

在 执行 hbbm2ddl 时 创建 一 个 数据 库 。 默 认 值 是 true 。 


outputfilename 


为 Hibernate3 插 件 的 构建 目标 配置 输出 文件 名 。 


implementation 


配置 Hibernate 映 射 的 源 文 件 。 有 效 值 可 以 是 configuration、 


annotationconfiguration 、jpaconfiguration 以 及 jdbcconfiguration ° 


还 有 其 他 几 个 配置 参数 ， 如 果 需 要 完整 的 列表 ， 可 以 查阅 Maven 
Hibernate3 项 目 网 站 上 的 Component Properties ('“!) 页 面 。 


注意 : Hibernate3 搬 件 目前 还 在 由 Mojo 进 行 开发 当中 ， 不 要 起 记 经 
常 查 看 项 目 网 站 上 的 更 新 信息 。 


可 以 为 某 个 组 件 (hbm2java 或 hbbm2ddl) 配置 它 的 每 个 配置 点 ， 也 
可 以 为 所 有 组 件 配置 它们 的 每 个 配置 点 。 由 于 例 12-3 并 没有 提供 任何 配 
置 属性 ， 所 以 Hibernate 会 按照 默认 配置 从 .hbm.xml 文 件 中 读 取 Hibernate 
映射 。 在 例 12-4 中 ，plug-in 配 置 改 写 了 hbm2ddl 目 标的 implementation 设 
置 ， 让 Hibernate 从 类 中 的 标注 来 读 取 映 射 信息 。 这 一 点 值得 再 详细 讨 


论 一 下 。 


属性 implementation 有 点 特殊 ， 它 可 以 设置 Hibernate3 插 件 获 得 
HibernateBR (EAT ZK o 有 4 种 选择 : 选择 configuration， 将 在 源 文 件 
目录 中 搜索 .hbm.xml 映 射 文件 ， 选 择 annotationcon-figuration， 将 在 编译 
过 的 类 中 搜索 Hibernate Annotations; jdbcconfiguration 利 用 反 向 工程 


(reverse engineering) ， 直 接 从 现 有 的 数据 库 中 生成 Hibernate 映 射 ; 
jpaconfiguration 与 annotationconfiguration 类 似 ， 只 是 它 查 找 的 是 
persistence.xml， 而 不 是 hibernate.cfg.xml] 配 置 文件 。 按 照 构 建 目 标 和 运行 
的 环境 ， 每 个 目标 都 有 其 默认 的 implementation 设 置 。 例 如 ， 在 JDK 1.4 
运行 环境 下 ，hbm2ddl 目 标的 默认 值 是 configuration; 而 在 Java SE 5 运 
行 环 境 下 ， 它 的 默认 值 就 是 annotationconfiguration。 有 关 所 有 
Hibernate3 构 建 目 标的 implementation 默 认 值 ， 可 以 参阅 Maven 
Hibernate3 项 目 网 站 上 的 Component Configuration (1) ” (组 件 配置 ) 
页 面 。 


生成 Hibernate 映 射 文档 


Maven Hibernate3 插 件 有 一 个 任务 是 可 以 为 一 套 Hibernate 映 射 创建 
文档 。 该 文档 与 JavaDoc 类 似 ， 详 细 描 述 了 数据 库 表 的 结构 和 相应 的 
Java 模 型 对 象 。 为 了 生成 这 个 文档 ， 需 要 在 运行 install 以 后 再 运行 
Hibernate3 插 件 的 hbbm2doc 构 建 目标 : 


~/examples/chi2$mvn install 
(output omitted) 
~/examples/chi2$mvn hibernate: hbm2doc 
[INFO]Scanning for projects... 
[INFO]Searching repository for plugin with prefix: 'hibernate3'. 
[INFO] = 


[INFO]Building Harnessing Hibernate: Chapter Twelve: Maven 
[INFO]task-segment: [hibernate3: hbm2doc] 


[INFO][hibernate3: hbm2doc] 
[INFO]using annotationconfiguration task. 
[INFO]Configuration XML file loaded: 
file: /Users/tobrien/svnw/hibernate- 
book/current/examples/chi2/src/main/resources/hibernate.cfg. xml 
[INFO]src/main/resources/database.properties not found within the 
project. 
Trying absolute path. 
[INFO]No hibernate properties file loaded. 
[INFON SSS eos eee ee oe eee eee 


[INFO] eee Sa ae a ee re ie A ele 


构建 目标 hbm2doc 执 行 完 成 以 后 ， 将 会 生成 HIML 文 档 
target/hibernate3/javadoc/index.html。 在 浏览 器 中 打开 这 个 页 面 ， 就 会 看 
到 一 组 描述 Hibernate 映 射 细节 的 HTML 文 档 。 可 以 从 数据 库 表 或 实体 的 
视图 来 浏览 Hibernate 映 射 。 从 实体 视图 (如 图 12-5 所 示 ) 可 以 查看 是 哪 
个 数据 库 表 关联 到 了 某 个 特定 实体 对 象 ， 而 数据 库 表 视图 (如 图 12-6 所 
示 ) 则 是 先 点 击 一 个 数据 库 表 ， 再 看 看 是 哪个 实体 对 象 映射 到 了 这 个 
特定 的 表 。 


Al Entities Tables Entities 


Packages 
com.oreilly .hh.data 
Entity Track 
com.oreilly.bhh.data.Track 

All Entities 

Album Identifier Summary 

fourier Name Column Type Description 

arts 

StereoVolume id Column Integer 

Track 
Property Summary 
Name Column Access Type Description 
added added field (get / set) Date 
artists field (get / set) Set<Artisi> 
comments field (get / set) Set<String> 
filePath fMiePath field (get / set) String 


jay Time play Time field (gèt / set) Date 
sourceMedia sourceMedia field (get / set) SourceMedia 


title TITLE field (get / set) String 
left 

volume — field (get / set) StereoVolume 
right 


图 12-5 hbm2doc 生 成 的 Track 实体 文档 


All Tables Tables Entities # HIBERN ATE 


Schemas 
default 
Schema default 
Table TRACK 
ee 
All Tables Column Summary 
ALBUM Name SqiType Length Precision Scale Nullable Unique 
ALBUM ARTISTS | TRACKID imeger 255 19 2 false false 
ALBUM COMMENTS | 
ALBUM TRACKS | IE varchan(255) 255 19 2 false false 
ARTIST filePath varchan(255) 255. 19 2 fase false 
EN — playTime time 255 19 2 true false 
TRACK COMMENTS | added date 255 19 2 true false 
j sourceMedia varchan(255) 255 19 2 true false 
left smaliint 255 19 2 false false 
right smalint 255 19 2 fase false 
Primary Key 
Name Columns 
TRACKPK TRACK ID 


图 12-6 hbm2doc 生 成 的 TRACK 数据 库 表 文档 
[1] http://mojo.codehaus.org/maven-hibenate3/hibernate3-maven-plugin/. 
[2] http://maven.apache.org. 
[3] http://mojo.codehaus.org. 
[4] http://mojo.codehaus.org/maven-hibernate3/hibemate3-maven- 
plugin/componentproperties.html. 
[5] http://mojo.codehaus.org/maven-hibernate3/hibernate3-maven- 


plugin/components.html. 


超越 Maven 


Maven 一 定 可 以 为 你 节省 不 少时 间 。 我 敢 肯 定 ， 一 定 是 这 样 的 。 
如 果 把 Maven 用 得 恰到好处 ， 你 将 不 必 再 为 维护 一 套 本 来 已 经 足够 陪 
明 的 程序 式 构 建 系统 而 花费 精力 (参阅 : 过 度 工程 (over- 
engineered) ) 。 但 是 ， 和 其 他 任何 技术 一 样 ，Maven 上 自身 也 存在 一 些 
问题 : 它 的 开发 文档 仍然 有 些 粗 糙 ， 甚 至 有 些 插件 〈 例 如 Hibernate3 插 
件 ) 还 没有 完整 的 文档 。 


TER: 如 果 Mojo 提 供 的 Hibernate3 揪 件 文档 不 能 让 你 感到 满意 ， 
应 该 批评 Tim 了 。 他 现在 正和 Mojo 的 维护 人 员 一 起 努力 改进 这 个 插 
件 。 希 望 当 你 读 到 这 本 书 时 ，Hibernate3 插 件 已 经 具备 完整 的 文档 了 。 
如 果 还 没有 ， 那 整 随便 给 他 发 个 邮件 催 一 下 吧 。 


回 开发 团队 中 引入 某 种 技术 非常 不 容易 ， 尤 其 是 那些 对 构建 结构 
或 数据 库 设计 之 类 的 东西 有 特殊 要 求 的 技术 。 我 曾经 见 到 过 有 些 团队 
拒绝 Hibernate， 古 因为 Hibernate 的 合集 映 喘 不 符合 数据 库 管 理 员 的 标 
准 。 也 见 到 过 某 些 组 织 拒绝 Hibernate， 是 因为 它 创建 的 SQL 达 不 到 开 
发 团队 认可 的 标准 。 对 Hibernate 的 批评 还 有 些 是 非常 抽象 的 ， 听 起 来 
好 像 是 什么 时 晓 的 艺术 评论 家 的 言论 (“关系 数据 库 是 一 种 过 时 的 结 
构 ”) 。 对 于 类 似 的 这 些 不 理性 的 批评 ，Maven 也 不 是 它们 的 陌生 人 。 


无 论 如 何 ， 我 们 当中 肯定 就 有 这 样 的 人 ， 因 为 可 能 必须 接受 某 种 标 
准 ， 所 以 束 不 愿意 使 用 可 以 节省 时 间 的 技术 。 如 果 你 决定 采用 Maven 
这 种 构建 工具 ， 那 么 在 开始 使 用 它 之 前 ， 务 必要 保证 团队 中 的 每 个 人 
都 要 接受 这 种 声明 式 (declarative) 构建 的 思想 。 


在 下 一 章 中 ， 我 打算 介绍 另 一 种 通过 提供 标准 和 约定 来 节省 更 多 
时 间 的 技术 。 你 刚 看 到 Maven 是 如 何 负责 项 目的 构建 ， 才 让 你 有 时 间 
坐 下 来 放松 一 会 儿 。 第 13 章 将 回 你 演示 如 何 用 Spring Framework 来 完成 
Hibernate 的 大 部 分 编码 工作 。 就 像 Maven 让 项 目 构建 变 得 不 费力 气 一 
样 ，Spring 让 使 用 Hibernate 变 得 更 加 容易 。 使 用 这 种 节省 时 间 的 技术 
也 会 有 一 定 的 风险 : 只 需要 花费 片刻 的 延迟 束 完 成 了 很 多 和 楷 杂 的 任 
务 ， 你 的 老板 可 能 因此 发 现 原 来 你 的 工作 这 么 们 单 ， 所 以 束 开 始 给 你 
分 配 一 堆 堆 的 任务 。 如 采 你 担心 像 管理 构建 过 程 或 编写 模板 代码 这 样 
繁杂 的 活 都 做 完 话 ， 我 建议 你 不 必 在 意 本 革 和 下 一 章 介绍 的 内 容 。 田 
一 方面 ， 你 可 以 接受 Maven 和 Spring， 而 用 节省 下 来 的 时 间 多 休息 一 会 
儿 ， 早 后 回 家 ， 或 者 在 Safari 上 阅读 更 多 的 在 线 电子 图 书 也 未 壬 不 可 。 


B13% Spring 入 | ]: Hibernate 与 Spring 


Spring 是 什么 


如 果 你 关注 一 下 最 近 几 年 Java 编 程 的 发 展 ， 或 许 应 该 听 说 过 Spring 
Framework ° Spring Framework 一 个 反 转 控制 (Inversion of Control, 
IoC) 容器 ， 并 集成 了 许多 附加 功能 和 模块 。 在 某 些 方面 ， 它 确实 只 是 
一 个 IoC 容 器 ;而 在 另 一 些 方面 ， 它 也 是 一 个 完整 的 应 用 程序 开发 平台 

(我 们 将 在 下 一 节 再 具体 介绍 这 些 概念 的 含义 ) 。 


Spring 最 初 由 Rod Johnson 在 2000 年 创建 ， 现 在 它 已 经 发 展 成 为 有 
望 代替 Enterprise Java Beans (EJB) 的 成 熟 框 架 。 在 2000 年 到 2004 年 之 
lA], Sun Microsystems 发 布 了 一 系列 针对 EJB 的 规范 。 原 来 如 采 不 编写 
大 量 重复 性 代码 ， 并 且 / 或 使 用 专 有 的 工具 来 屏蔽 底层 技术 ， 那 么 将 很 
难 理解 、 开 发 以 及 部 署 EJB。Rod 创 造 性 地 编著 了 《Expert One-on-One 
J2EE Design and Development) (2002 年 由 WROX 出 版 ，， 这 本 书 癌 
广大 开发 人 员 介绍 了 如 何 用 简单 的 IoC 容 器 和 一 系列 封装 API 来 取代 
EJB， 而 这 些 API 可 以 将 你 的 程序 与 Sun 的 底层 API 陋 离开 来 。 在 Spring 
中 不 需要 直接 与 JDBC、JMS 或 JTA API 直 接 交 互 ， 而 是 应 该 使 用 Spring 
提供 的 各 种 模板 类 和 辅助 类 。 虽 然 Sun 的 核心 企业 API 目 前 仍然 很 重 
要 ， 但 使 用 Spring 的 一 个 作用 束 是 放宽 了 Sun 在 定义 或 提议 的 新 库 和 应 


用 上 的 限制 。Spring 不 是 直接 对 JDBC 或 JNDI 进 行 编程 ， 而 是 在 Spring 
容 需 内 编写 目 己 的 代码 进行 操作 ， 这 样 束 不 必 了 解 实 现 持久 化 、 消 息 
传递 以 及 其 他 处 理 时 所 使 用 的 底层 技术 。 作 为 打破 Sun 在 Java 界 定制 标 
准 的 垄断 地 位 的 一 种 尝试 ，Spring 并 不 是 现在 惟一 的 项 目 ， 但 它 无 疑 
是 最 成 功 的 。 


你 可 能 会 写 一 些 自己 的 持久 化 层 对 象 来 直接 与 JDCB 交 互 ， 但 是 也 
可 以 使 用 Oracle 某 种 定制 的 专 有 代码 来 实现 一 部 分 ， 而 用 Hibernate 实 
现 剩余 的 其 他 部 分 。 Spring 通过 提供 一 个 神秘 的 IoC 容 妖 和 一 组 有 用 的 
抽象 ， 就 可 以 支持 这 种 选择 。 有 关 企 业 开 发 的 讨论 不 再 只 是 涉及 Sun 
和 Java; Community Process (JCP) 定制 的 各 种 标准 ， 相 反 ，Spring 通 
过 提供 一 种 公用 的 “总 线 ”(bus) ， 在 此 基础 上 可 以 构建 大 多 数 新 的 项 
目 应 用 ， 从 而 让 开发 企业 应 用 有 了 更 多 选择 。 以 Spring 与 Web 框 架 的 集 
成 为 例 : Wicket、Struts 2 (原来 的 WebWork) 、Stripes、GWT 以 及 
Tapestry 都 提供 了 与 Spring 的 优秀 集成 ， 而 String 的 文档 也 详细 介绍 了 
与 JavaServer Faces、Tapestry 以 及 WebWork 的 集成 。Spring 也 为 各 种 对 
象 关 系 映射 (Object Relational Mapping) 框架 提供 了 方便 的 集成 ， 包 
括 Hibernate、JDO、Oracle TopLink ` iBatis SQL Maps 以 及 JPA。Spring 
作为 一 个 平台 ， 可 以 让 开发 人 员 * 自 由 选择 各 种 实现 ， 在 一 定 程 度 上 
来 说 ， 现 在 几乎 所 有 新 的 开源 库 或 项 目 都 必须 支持 Spring Framework, 
才能 让 更 多 的 开发 人 员 愿 意 使 用 它 。 业 内 许多 人 士 一 致 认为 ， 虽然 


Sun 可 能 会 声称 Java 是 一 个 “平台 ”， 但 它 其实 只 是 一 种 编程 语言 ;而 


Spring 才 是 一 种 真正 的 平台 。 当 你 读 完 本 章 以 后 ， 就 会 对 Spring 如 何 接 
管 Hibernate 的 大 量 工 作 有 所 理解 。 


什么 是 反 转 控制 


对 于 IoC 还 没有 一 个 明确 的 定义 ， 但 比较 集中 的 一 个 就 是 依赖 注入 
(Dependency Injection) 。 在 Wikipedia 上 有 以 下 定义 : 


它 古 指 一 种 模式 ， 其 中 ， 对 和 象 创建 和 链接 的 控制 由 对 象 转移 到 了 
Lrs 


作为 一 种 轻 量 级 容器 ，Spring 负 责 将 一 套 组 件 集成 在 一 起 ， 通 过 
JavaBean 属 性 或 构造 参数 注入 依赖 对 象 的 实例 。 使 用 Spring， 你 可 以 先 
开发 一 系列 简单 的 对 象 ， 再 告诉 Spring 怎么 把 它们 串 接 起 来 以 创建 一 
个 更 大 的 系统 。 如 果 你 的 系统 架构 依赖 的 是 可 重用 的 “组 件 *"， 这 样 的 
实现 方法 就 非常 方便 。 在 本 划 中 ， 我 们 就 用 Spring Application Context 
将 数据 访问 对 象 (Data Access Objects, DAO) 实现 为 这 种 组 件 (或 
bean) ， 而 示例 类 则 通过 bean 的 属性 来 依赖 这 些 组 件 。 如 果 想 在 其 他 
系统 中 (例如 命令 行 工 具 或 Web 应 用 程序 ) 重用 这 些 DAO 类 ， 那 么 系 
统 可 以 按 bean 属 性 的 形式 来 依赖 同样 的 组 件 ，Spring 会 以 一 种 描述 程 
序 结构 的 XML 文档 为 基础 ， 把 各 种 组 件 都 串 接 起 来 。 


Spring 负责 将 一 套 功能 集中 的 组 件 串 接 在 一 起 ， 通 过 这 种 方法 来 
促进 组 件 的 重用 。 你 的 DAO 不 必 关 心 它 们 连接 到 什么 组 件 ， 或 是 什么 
组 件 会 使 用 它们 ; 它们 只 是 为 依赖 于 它们 的 组 件 提供 了 一 定 的 接口 。 
如 果 你 对 依赖 注入 或 反 转 控制 的 更 多 细 市 感 兴趣 ， 可 以 阅读 一 下 
Martin Fowler 的 《Inversion of Control Containers》 和 《Dependency 


Injection Patten) (''!) œ 


2H & Spring#l Hibernate 


现在 你 应 该 知道 Spring 是 做 什么 用 的 了 ， 我 们 回头 再 看 看 
Hibernate。 本章 集中 介绍 DAO 模 式 、 事 务 抽象 以 及 Spring Framework 
提供 的 工具 类 。 


你 希望 能 从 本 章 学 到 什么 ? 虽然 通过 Spring 来 使 用 Hibernate 相 当 
直接 ， 不 过 在 我 们 可 以 真正 利用 Spring 的 Hibernate 集 成 之 前 ， 还 需要 
几 步 准备 工作 。 首 先 ， 因 为 Spring 是 一 个 IoC 容 器 ， 所 以 需要 修改 前 几 
章 的 示例 ， 以 “ 捉 接 ”的 方式 来 创建 对 象 。 我 们 在 下 一 节 才 会 研究 DAO 
模式 。 在 创建 好 DAO 以 后 ， 将 修改 目前 的 这 套 示 例 ， 实 现 一 个 公共 接 
口 Test， 并 为 它 应 用 一 个 Transactional 标 注 。 接 着 ， 为 了 创建 Spring 应 
用 程序 上 下 文 ， 我 们 要 编写 一 个 XML 文档 ， 告 诉 Spring 要 创建 什么 对 
象 以 及 和 什么 对 象 串 接 起 来 。 最 后 ， 需 要 写 一 个 命令 行 应 用 程序 ， 用 
来 加 载 Spring 应 用 程序 上 下 文 和 启动 示例 程序 。 


注意 : 介绍 足够 了 ， 接 下 来 看 看 代码 吧 。 


添加 Spring 框 染 为 项 目 依赖 


为 了 在 示例 项 目 中 使 用 Spring， 需 要 为 构建 过 程 再 添加 一 个 依 
赖 。 打 开 build.xml， 添 加 例 13-1 中 用 粗 体 突出 显示 的 依赖 。 


例 13-1: 添加 Spring 依 赖 


<artifact: dependencies pathId="dependency.class.path"> 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency 
groupId="org.hibernate"artifactId="hibernate"version="3.2.4.spi"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency > 

<dependency groupId="org.hibernate"artifactId="hibernate- 
tools"version= 

"3.2.0.beta9a"/> 

< dependency groupId="org.hibernate"artifactId="hibernate- 
annotations" 

version="3.3.0.ga"/> 

< dependency groupId="org.hibernate"artifactId="hibernate- 
commons-annotations" 

version="3.3.0.ga"/> 

< dependency 
groupId="org.apache.geronimo.specs"artifactId="geronimo- 

jta_1.1_spec"version="1.1"/> 

< dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 

< dependency 
groupId="org.springframework"artifactId="spring"version="2.5"/> 

</artifact: dependencies > 


很 好 ， 现 运行 Ant build， 束 会 看 天 Maven Ant task 将 从 革 个 Maven 
仓库 中 下 载 spring-2.5.jar ° 


[1] http://martinfowler.com/articles/injection.html. 


编写 数据 访问 对 象 


数据 访问 对 象 (Data Access Object DAO) 是 一 种 常见 的 设计 模 
式 ， 用 于 分 离 应 用 程序 业务 逻辑 代码 和 访问 ， 处 理 数据 库 记 录 的 代 
码 。 在 更 大 型 的 体系 结构 中 ，DAO 层 可 以 作为 两 个 独立 的 体系 层次 的 
边界 。 我 们 以 Spring Framework 为 背景 来 介绍 DAO 对 象 ， 以 便 让 你 对 如 
何 将 Hibernate 应 用 到 整体 系统 架构 中 有 所 了 解 ; 同时 ， 之 所 以 要 介绍 
DAO 对 象 ， 也 是 因为 在 现实 世界 需要 与 数据 库 进行 交互 的 系统 
DAO 对 象 代表 了 一 种 常见 的 模式 。 


什么 是 数据 访问 对 象 


如 条 有 作者 用 20 多 页 的 篇 幅 来 介绍 DAO 模 式 、 它 的 优点 和 缺点 ， 
不 免 会 让 我 感到 吃惊 。 如 果 你 看 过 Sun J2EE 蓝 图 ， 它 就 用 很 多 篇 幅 解 
释 了 如 何 使 用 工厂 方法 的 DAO 创 建 模式 、 如 何在 更 大 的 方法 中 使 用 
DAO 模 式 以 支持 企业 应 用 程序 的 开发 。 我 们 准备 省 上 略 很 多 拘泥 于 形式 
的 细 方 ， 而 将 DAO 模 式 人 简单 地 概括 为 两 点 。DAO 模 式 如 下 : 


:将 所 有 持久 化 操作 (创建 、 读 取 、 更 新 、 删 除 ， 归 结 到 一 个 接口 
中 ， 通 常 按 数据 表 或 对 象 类 型 进行 组 织 。 


该 接口 具有 多 种 可 切换 的 实现 ， 可 以 支持 任意 各 类 的 持久 化 API 和 
JR TRAIT Jit ° 


或 者 ， 一 个 更 精简 的 定义 是 "DAO 将 持久 化 的 所 有 繁琐 细节 隐藏 在 
接口 之 后 ”。 


当 使 用 像 Hibernate 这 样 的 对 象 /关系 映射 (Object/Relational 
Mapping, ORM) 框架 时 ， 通 常 是 将 数据 库 作 为 一 套 对 象 来 处 理 。 本 书 
的 示例 涉及 3 个 对 象 ，Artist、Album、Track， 与 这 些 对 象 相 应 ， 我 们 打 
算 创 建 3 个 DAO 对 象 : ArtistDAO、AlbumDAO、TrackDAO。 图 13-1 简 
单 地 演示 了 要 创建 的 ArtistDAO 的 类 图 。 


可 miterfacen = 
i 
CsI + sessionFactory: SessionFactory 
+artistDac: ArtistDA0 | +persist(Artist artist): Artist 


oe +delete( Artist artisth: void  +gethibernateTemplate(): Hibernate Template 
+doSomething(): void | ‘HaniquebyHame(Stringname): Artist | +getSession(): Session 
etArtist String name, boolean create}: Artist 


+persest(Artist artist): Artist 
+delete(Artist artist): void 
+uniqueByName(Stringname): Artist 
+oethntist String name, boolean create) Artist 


图 13-1 用 数据 访问 对 象 来 分 离 应 用 的 业务 逻辑 和 持久 化 代码 


在 这 个 图 中 ， 你 的 应 用 程序 的 业务 逻辑 表示 为 YourClass 类 ， 这 个 
类 有 一 个 对 ArtistDAO 接 口 实例 的 引用 ， 该 接口 定义 了 4 个 简单 的 方 
法 : 


Artist persist (Artist artist) 


将 一 个 Artist 对 象 的 状态 保存 到 数据 库 中 。 根 据 artist 参 数 的 状态 ， 
这 个 方法 将 插入 一 个 新 记录 行 ， 或 更 新 一 个 已 有 的 记录 行 。 这 个 方法 
的 约定 是 检查 artist 参 数 的 id 属 性 :如果 id 属 性 是 null， 就 向 ARTIST 表 插 
入 一 个 新 行 ， 如 果 id 属 性 不 为 null， 就 更 新 数据 库 中 的 相应 行 。 该 方法 
返回 一 个 持久 化 的 Artist 对 象 ， 换 句 话说 ， 如 果 你 为 这 个 方法 传递 一 个 
id 属 性 为 null 的 Artist 对 象 ， 它 会 在 数据 库 中 创建 一 行 新 的 记录 ， 并 返回 
一 个 id 属 性 不 为 null 的 Artist 对 象 ， 这 时 的 id 属 性 包含 的 就 是 新 插入 记录 


的 标识 符 。 
void delete (Artist artist) 
从 数据 库 中 删除 匹配 的 记录 。 
Artist uniqueByName (String name) 
返回 姓名 等 于 name 参 数值 的 一 个 Artist 对 象 。 
Artist getArtist (String name, boolean create) 


查找 姓名 匹配 name 参 数值 的 Artist 对 象 。 如 果 create 参 数 为 tue， 则 
当 没 有 找到 匹配 的 Artist 对 象 时 ， 该 方法 就 用 提供 的 name 人 参数 来 创建 并 
持久 化 一 个 新 的 Artist 对 象 。 


虽然 在 YourClass 类 的 代码 中 引用 的 是 ArtistDAO 接 口 ， 但 实际 上 调 
用 的 是 ArtistDAO 接 口 的 一 个 实现 一 ArtistHibernateDAO“。 该 ArtistDAO 
的 实现 类 继承 了 Spring 的 HibernateDaoSupport 类 ， 这 个 Spring 提供 的 工 
有 具 类 包含 了 所 有 必需 的 魔力 ， 让 Hibernate 代 码 的 编写 变 得 尽 可 能 简 
单 。 使 用 HibernateDaoSupport， 你 可 以 不 必 编 写 前 面 儿 童 中 看 到 的 所 有 
异常 处 理 、 事 务 管理 以 及 session 管 理 代码 。 事 实 上 ， 我 想 你 一 定 感到 
惊讶 〈 也 可 能 有 些 失望 ) ， 在 Spring 中 使 用 Hibernate 变 得 这 么 简单 。 


本 书 使 用 以 下 命名 约定 ，DAO 接 口 在 com.oreillyhh.dao 包 中 进行 定 
义 ， 它 的 类 名 由 相关 联 的 对 象 名 称 再 附加 上 "DAO" 组 成 (例如 
ArtistDAO) 。 将 该 接口 的 Hibernate 特 定 实 现 命名 为 


ArtistHibernateDAO， 放 在 com.oreilly.hh.dao.hibernate 包 中 。 


为 什么 要 使 用 DAO 


之 所 以 要 使 用 DAO 有 很 多 原因 ， 但 第 一 个 也 是 最 重要 的 原因 是 这 
种 模式 可 以 增加 灵活 性 。 因 为 是 对 接口 进行 编码 ， 当 使 用 了 不 同 的 O/R 
映射 服务 或 存储 介质 时 ， 就 可 以 方便 地 构建 新 的 实现 。 在 前 面 的 介绍 
中 曾经 提 过 ，Spring 提 供 的 集成 层 可 以 使 用 许多 对 象 -关系 映射 技术 ， 

从 iBatis SQL Maps 到 Oracle 的 TopLink， 再 到 Hibernate， 但 Spring 也 提供 
了 一 套 丰富 的 抽象 ， 让 用 JDBC 执 行 SQL 变 得 相当 直接 。 在 我 经 历 过 的 
大 多 数 应 用 程序 开发 中 ，Hibernate 提 供 了 大 部 分 持久 化 逻辑 ， 但 它 并 


不 能 解决 所 有 问题 。 有 时 当 需 要 直接 执行 SQL 时 ， 直 接 使 用 Spring 提供 
的 JDBCTemplate 这 些 类 就 非常 方便 。 如 果 在 应 用 程序 的 业务 逻辑 层 和 
持久 层 之 间 插 入 DAO 接 口 ， 这 样 在 需要 的 时 候 ， 就 可 以 更 容易 地 切换 
到 其 他 特定 DAO 类 或 方法 的 实现 。 这 种 灵活 性 和 分 离 性 的 优点 体现 在 
两 个 方面 ， 其 一 是 可 以 容易 地 替换 特定 DAO 类 的 实现 ， 其 二 是 当 需 要 
重 写 或 更 新 应 用 程序 的 业务 逻辑 时 ， 可 以 重用 已 有 的 持久 化 层 。 本 书 
的 许多 读者 现在 直到 的 情形 十: 开发 团队 一 直 在 维护 一 个 用 Struts 1.x 编 
写 的 遗留 系统 ， 而 你 想 将 应 用 程序 升级 到 Stripes 或 Struts 2。 如 果 持 久 化 
代码 某 密 地 硝 合 到 了 Web 框 杂 代 码 中 ， 你 可 能 会 发 现 如 条 不 重 写 其 中 的 
一 方面 ， 束 不 可 能 重 写 另 一 方面 。 


对 于 这 么 简单 的 一 个 应 用 程序 ， 采 用 DAO 模 式 似乎 显得 没有 必 
要 ， 但 是 更 经 常 遇 到 的 情况 是 ， 你 需要 在 多 个 项 目 中 重用 持久 化 代 
码 。DAO 对 和 象 看 起 来 似乎 与 敏捷 开发 相 背 离 ， 但 这 种 在 复杂 度 上 的 付 
出 会 随 看 时 间 的 推移 而 体现 出 其 价值 。 如 果 你 的 系统 不 是 那 种 侧 单 
的 "Hello World" 例 子 ， 就 可 能 需要 花 些 时 间 将 持久 化 逻辑 从 应 用 程序 的 
业务 逻辑 中 分 离 出 来 。 


编写 ArtistDAO 接 口 


不 耽误 时 间 了 ， 我 们 看 看 这 个 示例 的 代码 编写 。 需 要 做 的 第 一 件 
事 就 是 编写 ArtistDAO 接 口 。 在 com.oreilly.hh.dao 包 中 创建 一 个 名 为 


ArtistDAO 的 接口 ， 并 将 例 13-2 所 示 的 代码 放 到 这 个 新 接口 中 。 


例 13-2: ArtistDAO 接 口 


package com.oreilly.hh.dao; 

import com.oreilly.hh.data.Artist; 

/** 

*Provides persistence operations for the Artist object 
*/ 

public interface ArtistDAO{ 

/** 

*Persist an Artist instance (create or update) 
*depending on the value of the id 


* 
bite Artist persist (Artist artist) ; 
K* 
cer an Artist from the database 
* 
shite void delete (Artist artist) ; 
Xk 
ae an Artist that matches the name argument 
* 
ire Artist uniqueByName (String name) ; 
/** 


*Returns the matching Artist object.If the 

*create parameter is true, this method will 

*insert a new Artist and return the newly created 
*Artist object. 

*/ 

public Artist getArtist (String name, boolean create) ; 


} 


好 ， 这 上段 代码 看 起 来 相对 比较 容易 ， 这 里 我 们 只 要 介绍 几 个 简单 
方法 的 实现 。 接 下 来 束 看 看 如 何 使 用 HibernateDaoSupport 类 来 实现 其 处 
理 逻 辑 。 


实现 ArtistDAO 接 口 


下 一 步 就 应 该 编写 ArtistDAO 的 实现 。 我 们 打算 编写 一 个 
ArtistHibernateDAO 类 来 实现 ArtistDAO 接 口 ， 并 继承 Spring 的 
HibernateDaoSupport2e ° HibernateDaoSupport#e ft T XfHibernate Session 
对 象 和 HibernateTemplate 的 访问 ， 可 以 用 HibernateTemplate 来 简化 对 
Hibernate Session 对 象 任意 的 操作 。 为 了 实现 ArtistDAO， 先 在 
com.oreilly.hh.dao.hibernate 包 中 创建 一 个 新 类 ， 证 它 包 含 例 13-3 所 示 的 
ArtistDAO 接 口 的 特定 于 Hibernate 的 实现 。 


例 13-3: 实现 ArtistDAO 接 口 


package com.oreilly.hh.dao.hibernate; 

import java.util.HashSet; 

import org.apache.1log4j.Logger; 

import org.hibernate.Query; 

import 
org.springframework.orm.hibernate3.support.HibernateDaoSupport; 

import com.oreilly.hh.dao.ArtistDAO; 

import com.oreilly.hh.data.Artist; 

import com.oreilly.hh.data.Track; 

JER 

*Hibernate-specific implementation of the ArtistDAO 
interface.This class 

*extends the Spring-specific HibernateDaoSupport to provide 
access to 

*the SessionFactory and the HibernateTemplate. 

*/ 

public class ArtistHibernateDAO extends HibernateDaoSupport 

implements ArtistDAO{ 

private static Logger log= 

Logger .getLogger (ArtistHibernateDAO.class) ; 

/* (non-Javadoc) 

*@see com.oreilly.hh.dao.ArtistDAO#persist 
(com.oreilly.hh.data.Artist) 

*/ 

public Artist persist (Artist artist) {@ 

return (Artist) getHibernateTemplate () .merge (artist) ; 


} 


/* (non-Javadoc) 

*@see com.oreilly.hh.dao.ArtistDAO#delete 
(com.oreilly.hh.data.Artist) 

oy: 

public void delete (Artist artist) {@ 

getHibernateTemplate () .delete (artist) ; 


/* (non- Javadoc) 

*@see com.oreilly.hh.dao.ArtistDAO#uniqueByName 
(java.lang.String) 

*/ 

public Artist uniqueByName (final String name) {© 

return (Artist) getHibernateTemplate () .execute (new 

HibernateCallback () { 

public Object doInHibernate (Session session) { 

Query query=getSession () .getNamedQuery 
("com.oreilly.hh.artistByName") ; 

query.setString ("name", name) ; 

return (Artist) query.uniqueResult () ; 

} 

P: 

} 

/* (non- Javadoc) 

*@see com.oreilly.hh.dao.ArtistDAO#getArtist (java.lang.String, 

boolean) 

sa 

public Artist getArtist (String name, boolean create) {0 

Artist found=uniqueByName (name) ; 

if (found==null&&create) { 

found=new Artist (name, new HashSet<Track> () , null) ; 

found=persist (found) ; 


if (found! =null&&found.getActualArtist () ! =null) { 
return found.getActualArtist () ; 


} 


return found; 


} 

} 
@ 这 个 persist () 方法 只 是 简单 地 调用 HibernateTemplate 的 merge 
O 方法 。merge () 方法 的 实现 会 检查 artist 参 数 的 id 属性 。 如 果 id 为 
null, merge () 方法 就 品 ARTIST 表 插入 一 行 新 的 记录 ， 并 返回 一 个 带 


有 生成 的 id 属性 的 Artist 新 实例 。 如 果 id 属 性 不 为 null, merge () 方法 就 
会 先 查 找 匹配 的 记录 行 ， 再 用 artist 参 数 的 内 容 来 更 新 这 一 记录 。 


@delete () 只 是 将 artist 参 数 传递 给 HibernateTemplate 的 delete () 
方法 。 该 方法 需要 接收 一 个 其 id 属性 不 为 nul 的 对 象 ， 并 删除 ARIIST 表 
中 的 相应 数据 行 。 


@uniqueByName () 才 是 更 有 趣 的 开始 。 此 处 是 我 们 在 这 个 类 中 
第 一 次 引用 Session 对 象 ， 在 整 本 书 中 曾经 一 直 在 使 用 它 。 首 移 用 
getSession () 获取 一 个 NamedQuery。 接 着 再 设置 命名 参数 name， 取 回 
一 个 惟一 的 查询 结果 。 如 果 数 据 库 中 没有 匹配 的 Artist, uniqueResult 
() 将 返回 nul。 相 信 你 也 注意 到 这 里 使 用 了 一 个 匿名 的 
HibernateCallback 实 例 ， 并 将 它 传 递 给 HibernateTemplate 对 象 。 有 关 
HibernateCallback 类 的 更 多 信息 ， 可 以 参阅 本 章 后 面 的 13.2.6 节 。 


@getArtist () 方法 实际 上 只 是 将 查询 转交 给 了 ArtistDAO 中 的 其 他 
方法 。 它 通过 调用 uniqueByName () ， 按 照 名 称 来 取 回 一 个 Artist 对 
象 。 如 果 没 有 找到 任何 Artist 对 象 ， 而 且 create 参 数 为 true, getArtist () 
方法 就 会 创建 一 个 id 属 性 为 null 的 Artist 实 例 ， 再 调用 persist () 方法 。 
如 果 没 有 找到 匹配 的 Artist 对 象 ， 而 且 create 参 数 为 false， 这 个 方法 就 会 
返回 nul。 如 果 找 到 的 或 新 创建 的 Artist 对 象 具 有 一 个 非 null 的 
actualArtist 属 性 ， 这 个 方法 将 返回 artist.getActualArtist () 的 值 。 (这 
一 步骤 的 目的 可 以 参阅 第 5.5 节 的 解释 。) 


HibernateDaoSupport 的 功能 


HibernateDaoSupport 可 以 让 我 们 连接 到 SessionFactory， 但 不 必 知 
道 Hibernate 环 境 是 怎么 创建 或 配置 的 。 当 将 HibernateDaoSupport 子 类 化 
(subclass) 到 我 们 的 DAO 类 后 ， 就 可 以 通过 getSession () 方法 访问 
Hibernate Session， 通 过 getHibernateTemplate () 方法 访问 Hibernate- 
Template。 你 应 该 已 经 知道 用 Hibernate Session 对 象 可 以 做 什么 〈 就 是 
本 书 前 面 10 章 的 内 容 ) 。Spring/Hibernate 集 成 中 有 趣 的 部 分 是 由 
HibernateTemplate 类 提供 的 ， 我 们 接 下 来 束 深 入 人 研究 一 下 这 个 类 的 细 


+H 


Td ie) 


根据 HibernateTemplate 的 JavDoc 中 的 说 明 : “可 以 用 这 个 类 来 取代 
对 原始 Hibernate 3 Session API 的 使 用 。”HibernateTemplate 简 化 了 原本 
用 Session 对 象 完成 的 任务 ， 同 时 将 Hibernate-Exception 转 换 为 多 个 通用 
的 DataAccessException。 可 以 用 两 种 方法 来 使 用 HibernateTemplate: W] 
用 一 套 简 单 的 工具 函数 ， 例 如 load () 、save () 、delete () ; 或 者 使 
用 execute () 方法 来 执行 一 个 HibernateCallback 实 例 的 调用 。 在 大 多 数 
情况 下 ， 使 用 HibernateTemplate 的 简单 工具 函数 就 足够 了 ; 只 有 要 在 
HibernateTemplate 内 执行 某 些 Hibernate 特 定 的 代码 时 ， 才 需要 创建 一 个 
HibernateCallback 对 象 。 


DataAccessException 是 什么 ? 在 前 面 介绍 DAO 设 计 模 式 时 ， 就 说 
过 它 的 目的 就 是 要 向 应 用 程序 代码 屏蔽 属于 任何 持久 化 API 或 库 的 特殊 


性 。 如 果 我 们 独立 于 特定 技术 的 DAO 抛 出 一 个 Hibernate 特 定 的 
ObjectNotFoundException 异 常 ， 束 对 我 们 没什么 帮助 了 。 所 以 
Hibernate-Template 束 需要 负责 处 理 可 能 在 其 中 发 生 的 任何 Hibernate 特 
REAP AS © Stripes API 通 过 将 这 些 特定 实现 的 异常 封 儿 到 它 目 己 通用 的 
数据 访问 异常 中 ， 提 供 了 一 种 对 这 种 异常 进行 包容 的 倍 单 方法 。 


HibernateTemplate 和 HibernateCallback 是 帮助 我 们 避免 编写 一 行 义 
一 行 不 必要 的 Java 代 码 的 实际 骨干 。 接 下 来 就 使 用 它们 两 个 来 重新 实现 
前 面 几 章 中 的 示例 。 


应 该 怎么 做 


在 使 用 HibernateTemplate 和 HibernateCallback 之 前 ， 我 们 需要 先 大 
致 看 看 它们 提供 的 方法 。HibernateTemplate 提 供 了 很 多 简单 方便 的 方 
法 ， 可 以 将 原来 直接 使 用 Hibernate Session API 时 需要 多 行 代码 才能 完 
成 的 功能 压缩 到 只 需要 简单 的 一 行 。 我 们 以 查询 数据 库 表 为 例 ， 来 看 
看 这 种 简单 方法 到 底 是 怎么 回 事 。 例 13-4 演 示 了 查询 和 搜索 对 象 的 几 个 


示例 。 


例 13-4: HibernateTemplate 的 find () 工具 方法 


HibernateTemplate tmpl=getHibernateTemplate () ; 

//All of these lines Find Artist with name'Pavement' 

List artists=tmpl.find ("from com.oreilly.hh.data.Artist a"+ 
"where a.name='Pavement'") ; @ 

String name="Pavement"; 


List artists=tmpl.find ("from com.oreilly.hh.data.Artist a"+ 

"where a.name=?", name) ; @ 

List artists=tmpl.findByNamedParam ("from 
com.oreilly.hh.data.Artist a"+ 

"where a.name=: name", "name", name) ; © 

//Assuming that there is a NamedQuery annotation"Artist.byName"on 
the 

//Artist class 

List artists=tmpl.findByNamedQuery ("Artist.byName", name) ; @ 

Artist artist=new Artist () ; 

artist.setName ("Pavement") ; 

List artists=tmpl.findByExample (artist) ; © 

//If we want to iterate through the result 

Iterator artists=tmpl.iterate ("from com.oreilly.hh.data.Artist"+ 

"where a.name=?", name) ; @ 

//The following lines find all Artists 

List artists=tmpl.find ("from com.oreilly.hh.data.Artist") ; @ 

List artists=tmpl.loadAll (Artist.class) 


Find 方 法 相对 比较 直接 ; 


@ 这 是 一 个 简单 的 find O 方法 ， 接 受 一 个 不 带 参 数 的 HQL 查 询 语 
名。 


@ 访 方法 的 这 个 版 本 接受 一 个 HQL 查 询 语句 ， 以 及 一 个 附加 的 参 
数 。 类 似 地 男 一 个 版 本 将 接受 一 个 查询 语句 和 一 组 附加 的 参数 : List 
find (String hql, Object[]params) 。 这 些 方法 都 支持 非 命名 查询 参数 的 
使 用 ， 但 正如 第 3 章 所 述 ， 编 写 查询 还 有 更 好 的 方法 。 


©findByNamedParameter () 方法 可 以 处 理 带 有 命名 参数 的 查询 。 


@findByNamedQuery () 方法 可 以 让 你 快速 调用 一 个 预定 义 的 
HQL 查 询 ， 在 这 个 例子 中 是 名 为 "Artist.byName" 的 查询 。 


人 @ 通 过 findByExample () 方法 ， 还 可 以 使 用 Hibernate 的 示例 查询 
(query-by-example) 的 功能 。 


@ 如 果 想 循环 遍历 查询 结果 ， 可 以 调用 iterate () 方法 。 当 调用 
iterate () 方法 时 ，Hibernate 首 先 取 回 匹 配 数据 行 的 所 有 ID， 当 通过 返 
回 的 Iterator 遍 历 结 果 时 ， 再 初始 化 各 个 元 素 。 


@ 最 后 ， 如 果 只 是 想 加 载 给 定 某 个 表 的 所 有 数据 行 ， 则 可 以 调用 
find () 或 loadAll () 方法 。 


正如 第 3.4 节 所 讨论 的 ， 命 名 查询 是 一 种 将 查询 定义 移出 DAO 代 码 
的 好 办 读 。 如 有 果 你 使 用 的 是 标注 ， 可 以 使 用 @NamedQuery 标 注 来 定义 
命名 查询 。 有 关 该 标注 的 更 多 细节 可 以 参阅 第 7 章 的 相关 内 容 。 


如 果 我 们 已 经 知道 了 某 个 持久 对 象 的 ID 值 ， 束 可 以 用 
HibernateTemplate 提 供 的 工具 方法 通过 ID 来 加 载 对 象 ， 如 例 13-5 所 示 。 


例 13-5: 用 HibernateTemplate 加 载 对 象 


//Identifier of Artist to load 

Integer id=1; 

//Load an Artist object, return persistent Artist object 
Artist artist=getHibernateTemplate () .load (Artist.class, id) ; 
//Populate the object passed in as a parameter.Using the 
//object's type to specify the class 

Artist artist=new Artist () ; 

getHibernateTemplate () .load (artist, id) ; 


在 第 1 个 例子 中 ， 我 们 用 一 个 Class 和 序列 化 ID 值 来 调用 load O Ex 
数 。Hibernate 将 从 数据 库 中 检索 对 应 的 记录 ， 并 返回 请 求 对 象 的 实 
例 。 除 了 使 用 Class 对 象 ， 你 也 可 以 传递 一 个 对 象 实例 ，Hibernate 会 用 
参数 的 类 型 来 决定 检索 哪个 类 。 


我 们 已 经 看 过 了 HibernateTemplate 中 用 于 查询 和 加 载 对 象 的 工具 方 
法 。 那 么 怎样 修改 数据 库 中 的 记录 呢 ? 例 13-6 演 示 了 几 个 在 数据 库 中 揪 
入 和 更 新 记录 的 示例 。 


例 13-6: 用 HibernateTemplate 保 存 和 更 新 记录 


//Persist a new instance in the database 

Artist a=new Artist () 

a.setName ("Fischerspooner") ; 

getHibernateTemplate () .save (a) ; 

//Load, modify, update a row in the database 

Artist a=getHibernateTemplate () .load (Artist.class, 1) ; 
a.setName ("Milli Vanilli") ; 

getHibernateTemplate () .update (a) ; 

//Either insert or update depending on the identifier 
//of the object; associate resulting object with Session 
Artist a=getHibernateTemplate () .merge (a) ; 


Save () 和 update () 方法 也 比较 直观 ， 这 两 个 方法 与 Hibernate 
Session 对 象 上 的 同名 方法 类 似 。Save () 方法 生成 一 个 新 的 ID ， 并 向 
数据 表 中 插入 一 行 新 的 记录 ; update O 方法 则 更 新 数据 库 表 中 的 匹配 
WK ° merge () 方法 更 灵活 些 : 它 会 检查 参数 的 id 属性 ， 按 照 ID 是 否 
为 null 来 调用 save () 或 update () 方法 。 


也 可 以 通过 HibernateCallback， 使 用 Hibernate Session 来 执行 任何 
SQL 语句 。 在 详细 解释 这 一 用 法 之 前 ， 我 们 移 看 看 例 13-7。 


例 13-7: 编写 HibernateCallback 


final String name="Pavement"; 

Artist artist= (Artist) getHibernateTemplate () .execute (new 
HibernateCallback () { 

public Object doInHibernate (Session session) { 

Criteria criteria=session.createCriteria (Artist.class) ; 

criteria.add (Restrictions.like ("name", name) ) ; 

return criteria.uniqueResult () ; 


7 
那么 这 个 例子 中 到 压 发 生 了 什么 ?这 个 示例 首先 实例 化 一 个 实现 
了 HibernateCallback 接 口 的 匿名 内 部 类 ， 并 将 它 传递 给 
HibernateTemplate 的 execute () 方法 。HibernateCallback 接 口 只 定义 了 
一 个 方法 doInHibernate () ， 需 要 向 它 传递 一 个 Hibernate Session。 在 
这 个 方法 的 内 部 〈 在 我 们 的 匿名 内 部 类 中 实现 的 ) 使 用 Hibernate 
Criteria API 生 成 查询 ， 按 姓名 检索 回 一 个 Artist 对 象 。 


为 什么 当 我 们 本 来 能 够 容易 地 获得 Hibernate Session 的 引用 ， 而 且 
也 能 创建 同样 的 Criteria 对 象 时 ， 却 要 使 用 回调 方法 ? 即使 在 
HibernateDaoSupport 中 使 用 getSession () 方法 能 够 直接 访问 Session 对 
象 ， 我 们 还 是 希望 避免 直接 调用 Hibernate API， 因 为 我 们 不 想 抛 出 任何 
Hibernate 特 定 的 异常 (甚至 也 不 想 抛 出 RuntimeException) 。 需 要 记 
住 ， 你 的 应 用 程序 正在 通过 一 个 接口 来 访问 这 个 DAO， 它 不 知道 也 不 


关心 Hibernate 特 定 的 ObjectNotFoundException 或 HQL 中 的 异常 。 不 是 直 
接 用 getSession () 访问 Session 对 象 ， 你 能 够 也 应 该 向 你 的 应 用 程序 屏 
燕 这些 确 层 处 理 细 和 ， 这 束 是 为 什么 要 在 HibernateTemplate 中 用 
HibernateCallback 来 运行 Hibernate API 调 用 的 原因 了 。 


其 他 DAO 在 哪里 


因为 这 些 DAO 处 理 都 非常 相似 ， 所 以 不 值得 在 这 里 一 一 列 出 和 讨 
论 其 他 DAO 处 理 了 。 你 可 能 不 想 手工 输入 所 有 代码 ， 如 果 还 想 看 看 它 
们 的 话 ， 只 要 下 载 代 码 示例 就 可 以 了 。 


创建 应 用 程序 上 下 文 对 象 


前 面 介 绍 Spring 时 ， 我 们 讨论 了 它 如 何 负责 创建 和 连接 应 用 程序 中 
的 组 件 。 为 了 让 Spring 组 装 各 组 件 ， 我 们 需要 告诉 它 系 统 中 有 什么 组 件 
Spring 将 它们 称 为 bean) 以 及 它们 之 间 是 如 何 连接 在 一 起 的 。 我 们 使 
用 一 个 XML 文 档 来 描述 每 个 bean 的 类 ， 为 每 个 bean 分 配 一 个 ID， 建 立 
起 各 个 bean 之 间 的 关联 关系 。 为 什么 要 用 ID? Spring t, DREA 
bean 的 惟一 的 逻辑 名 称 ， 在 表达 bean 之 间 的 关系 ， 以 及 在 运行 时 请 求 
bean 时 ， 束 会 用 到 bean 的 ID 属性 。 在 我 们 的 示例 Spring 配置 文件 中 ， 束 
使 用 了 诸如 artistDao 和 albumDao 之 类 的 逻辑 名 称 ， 每 个 ID 引用 了 在 配 
置 文件 中 定义 的 一 个 组 件 。 


Spring 再 用 这 个 XML 文 档 来 创建 一 个 ApplicationContext 对 象 ， 利 用 
这 个 对 象 我 们 就 可 以 按 名 称 取 回 相应 的 组 件 。 图 13-2 是 我 们 这 个 程序 
ApplicationContext 的 内 容 结 构图 表 。 


图 13-2 我 们 的 Spring 应 用 程序 上 下 文 


从 图 13-2 中 可 以 看 到 ， 我 们 的 3 个 测试 组 件 与 3 个 DAO 对 象 连接 在 
一 起 ， 每 个 DAO 对 象 都 有 一 个 会 话 工 厂 对 象 引 用 ， 它 负责 创建 一 个 
Hibernate 会 话 对 象 和 连接 到 数据 库 。 这 个 应 用 程序 的 Spring 配置 文件 如 
例 13-8 所 示 ， 应 该 将 它 命名 为 applicationContext.xml， 并 放 在 src 目 录 
ace 


例 13-8: Spring 的 配置 文件 applicationContext.xml 


<?xml version="1.0"encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns: xsi="http://www.w3.org/2001/XMLSchema- instance" 

Xmlns: tx="http://www.springframework.org/schema/tx" 

xsi: schemaLocation= 

http://www. springframework.org/schema/beans 

http://www. springframework.org/schema/beans/spring-beans-2.0.xsd 
http://www. springframework.org/schema/tx 

http://www. springframework.org/schema/tx/spring-tx-2.0.xsd" 
default-lazy-init="true">@ 

<bean id="sessionFactory"@ 
class="org.springframework.orm.hibernate3.annotation.Annotation 
SessionFactoryBean" > 

<property name="annotatedClasses">®© 

<list> 

<value>com.oreilly.hh.data.Album</value> 
<value>com.oreilly.hh.data.AlbumTrack</value> 
<value>com.oreilly.hh.data.Artist </value> 
<value>com.oreilly.hh.data.StereoVolume</value > 
<value>com.oreilly.hh.data.Track</value> 

</list> 

</property> 

<property name="hibernateProperties" >® 

<props> 

<prop key="hibernate.show_sql" >false</prop> 

<prop key="hibernate.format_sql">true</prop> 

<prop key="hibernate.transaction.factory_class">org.hibernate. 
transaction. JDBCTransactionFactory</prop> 


<prop key="hibernate.dialect">org.hibernate.dialect .HSQLDialect 


</prop> 


<prop key="hibernate.connection. 
.driver_class">org.hsqldb 


<prop key="hibernate.connection 
. }dbcDriver </prop> 


<prop key="hibernate.connection. 


shutdown=true< /prop > 


<prop key="hibernate.connection. 
<prop key="hibernate.connection. 


pool_size">0</prop> 


url" >jdbc: hsqldb: data/music; 


username" >sa</prop> 
password" > </prop> 


</props> 

</property> 

</bean> 

<! --enable the configuration of transactional behavior based on 

annotations- -> 

<tx: annotation-driven transaction-manager="transactionManager"/ 
> 日 

<bean id="transactionManager" 

class="org.springframework.orm.hibernate3.HibernateTransactionMan 
ager"> 

<property name="sessionFactory" > 

<ref local="sessionFactory"/> 

</property> 

</bean> 

<bean 
class="org.springframework.beans.factory.annotation.RequiredAnnotati 
on 

BeanPostProcessor"/>®@ 


<! --Define our Data Access beans-- > 

<bean 
id="albumDAO"class="com.oreilly.hh.dao.hibernate.AlbumHibernateDAO" 
>0 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<bean 


id="artistDAO"class="com.oreilly.hh.dao.hibernate.ArtistHibernateDAO 
hes 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<bean 
id="trackDAO"class="com.oreilly.hh.dao.hibernate.TrackHibernateDAO" 
> 

<property name="sessionFactory"ref="sessionFactory"/> 

</bean> 

<! --Define our Test beans--> 

<bean id="createTest"class="com.oreilly.hh.CreateTest"> © 

<property name="trackDAO"ref="trackDAO"/ > 

<property name="artistDAO"ref="artistDAO"/ > 

</bean> 


<bean id="queryTest"class="com.oreilly.hh.QueryTest" > 
<property name="trackDAO"ref="trackDAO"/ > 

</bean> 

<bean id="albumTest"class="com.oreilly.hh.AlbumTest" > 
<property name="albumDAO"ref="albumDAO"/ > 

<property name="artistDAO"ref="artistDAO"/ > 
<property name="trackDAO"ref="trackDAO"/ > 

</bean> 

</beans> 


咽 ， 要 读 的 XML 代 码 量 还 不 小 ， 不 是 吗 ? 其 实在 这 个 文件 中 还 有 
很 多 有 趣 的 东西 ， 接 下 来 就 细 细 梳理 一 下 这 个 文件 中 的 每 个 


@ 顶 级 元 素 是 <beans>>， 为 了 让 Spring 能 够 正常 运行 ， 我 们 必须 为 
其 声明 一 些 重要 有 的 命名 空间 。 
http:/www.springframework.org/schema/beans 命 名 空间 是 用 于 摘 述 声明 
的 bean 元 和 聚 的 默认 命名 空间 ， 而 
http://www.springframework.org/schema/tx 命 名 空间 则 用 于 定义 标注 张 动 
的 事务 配置 ， 本 章 稍 后 会 介绍 这 一 内 容 。< default-lazy-init> 属性 控制 
Spring IoC 容 妖 的 默认 行为 。 如 果 该 默认 设置 为 tue， 则 只 有 当 请 求 组 
件 时 ，Spring 才 会 实例 化 这 些 组 件 。 如 果 把 default-lazy-init 设 置 为 
false， 则 Spring 在 ApplicationContext 初 始 化 期 间 就 实例 化 相关 的 bean 。 


会 话 工 厂 这 个 bean 负 责 生 成 会 话 对 象 ， 处 理 到 JDBC DataSource 
的 连接 。 ， 会 话 工 厂 将 使 用 一 个 DataSource， 我 们 在 
applicationContext.xml 中 可 以 为 会 话 工厂 配置 一 个 Commons DBCP 或 


C3P0 连 接 。 为 了 保持 这 个 例子 的 完整 性 ， 会 话 工 上 的 配置 直接 包含 了 
用 于 配置 JDBC 连 接 的 各 属性 。 


日 和 在 hibernate.cfg.xml 文 件 中 进行 配置 一 样 ， 此 处 是 在 定义 需要 
Hibernate 处 理 的 标注 类 。 


@hibernateProperties 元 素 用 于 配置 Hibernate 的 设置 。 稍 后 在 本 章 的 
13.3.1 太 再 深入 介绍 这 一 配置 的 细 廊 。 


日 事务 管理 相关 的 标注 配置 稍 后 在 本 章 的 13.4.1 节 再 深入 介绍 。 
tx: annotation-driven 元 素 和 transactionManager 定 义 可 以 让 我 们 使 用 
Transactional 标 注 来 定义 应 用 程序 中 任何 事务 的 范围 和 属性 。 


@RequiredAnnotationBeanPostProcessor 是 一 个 没有 命名 的 组 件 ， 有 
了 这 个 组 件 ， 就 可 以 为 带 有 Required 标 的 setter 方 法 激活 一 些 强制 处 理 。 
如 果 将 这 个 Required 标 注 属性 放 在 必需 的 bean 属 性 的 setter 方 法 上 ， 
Spring 束 会 在 初始 化 一 个 bean 后 ， 再 验证 这 个 属性 是 否 伞 设 置 。 在 测试 
类 中 可 以 用 这 种 方法 来 确保 Spring 已 经 配置 好 了 我 们 的 DAO 依 赖 。 


@ 在 这 里 定义 好 了 DAO 对 象 ，albumDAO、artistDAO 以 及 
trackDAO 。 


@ 在 这 里 定义 好 了 test bean: createTest、queryTest 以 及 albumTest ° 


Hibernate 配 置 属性 


仔细 看 看 例 13-8 中 的 hibernateProperties 部 分 ， 其 中 有 许多 有 趣 的 配 
置 属性 ， 分 别 解释 如 下 : 


hibernate.connection.driver_class ` hibernate.connection.url ` 


hibernate.connection.username 、 hibernate.connection.password 


这 几 个 配置 属性 负责 配置 数据 库 的 JDBC 连 接 。 这 些 属 性 与 前 面 几 
章 中 的 配置 属性 类 似 ， 它 们 在 applicationContext.xml 中 的 属性 值 与 早先 
在 hibernate.cfg.xml 和 hibernate.properties 中 的 取 值 完全 一 样 。 


hibernate.connection.pool_size 


这 个 属性 用 于 设置 Hibernate 内 部 连接 池 (connection pool) 容量 的 
大 小 。 如 果 不 使 用 Hibernate 提 供 的 连接 池 ， 也 可 以 使 用 Hibernate 内 建 的 
支持 Apache Commons DBCP 或 C3P0， 对 于 产品 级 系统 的 部 署 ， 这 两 种 
连接 池 都 是 很 好 的 选择 。 如 果 将 这 个 属性 值 设 置 成 一 个 非 零 的 数值 ， 
Hibernate 束 会 负责 回收 和 重用 数据 库 的 连接 。 


这 种 情况 很 有 趣 ， 因 为 我 想 为 这 个 示例 关 掉 连 接 池 ， 以 简化 
HSQLDB 的 使 用 ， 所 以 将 pool_size 设 置 为 0。 当 最 后 一 个 数据 库 连 接 终 
止 时 ，HSQLDB 需 要 接收 一 个 SHUTDOWN 命 令 ， 因 为 在 这 里 我 不 想 再 
编写 和 配置 一 个 专门 的 关闭 脚本 ， 而 是 简单 地 保证 在 用 完 ]DBC 
Connection 对 象 后 就 马上 关闭 它 。 


hibernate.dialect 


这 个 属性 用 于 设置 Hibernate 方 言 (dialect) 。 现 在 Hibernate 支 持 的 
所 有 方言 列表 ， 请 参阅 附录 C。 


hibernate.transaction.factory_class 


在 这 个 示例 中 ， 我 们 使 用 JDBC 驱 动 程序 来 管理 数据 库 事 务 。 更 复 
杂 的 部 署 环境 需要 使 用 JTA， 如 果 我 们 使 用 容 眉 托管 的 事务 ， 则 可 以 将 
该 属性 配置 为 org.hibernate.transaction.JTATransactionFactory。 


hibernate.show_sql ` hibernate.format_sql 


如 果 将 show_sql 设 置 为 true, Hibernate 将 打印 输出 它 正在 执行 的 SQL 
语句 。 如 果 你 在 调试 Spring， 想 弄 清 楚 某 个 映射 是 起 么 访问 数据 库 表 
的 ， 这 个 配置 属性 束 很 有 用 。 如 采 将 format sql 设置 为 rue， 束 会 格式 
化 输出 的 SQL 语句 ; 如 果 将 format_ sql 设置 为 false, SQL 语句 只 打印 输出 
Dl 


把 所 有 组 件 淡 配 在 一 起 


如 果 我 们 不 知道 如 何 创建 一 个 Spring ApplicationContext 和 运行 我 
们 的 代码 ， 所 有 这 些 Spring 配 置 也 就 没什么 用 途 。 在 本 市 ， 我 们 打算 
调整 前 面 的 示例 CreateTest、QueryTest、AlbumTest 类 ， 实 现 一 个 Test 接 
口 ， 不 是 直接 从 命令 行 运行 它们 ， 而 是 创建 一 个 TestRunner 来 执行 这 
些 从 Spring ApplicationContext 获 取 的 测试 对 象 。 


Transactions: 测试 接口 


本 章 稍 后 会 编写 一 个 名 为 TestRunner 的 类 ， 这 个 类 会 知道 怎么 从 
Spring ApplicationContext 中 取 回 一 个 bean， 这 个 bean 应 该 实现 Test 接 

需要 调用 执行 该 bean 的 run () 方法 。TestRunner 使 用 的 bean 源 于 
对 前 面 几 章 的 CreateTest、QueryTest 以 及 AlbumTest 的 修改 调整 。 为 了 
支持 这 种 新 的 运行 方式 ， 我 们 让 它们 分 别 实现 一 个 公共 的 Test 接 口 ， 
如 例 13-9 所 示 。 


例 13-9: Test 接 口 


package com.oreilly.hh; 

import 
org.springframework.transaction.annotation. Transactional; 

JEF 

*A common interface for our example classes.We'll need this 

*because TestHarness needs to cast CreateTest, QueryTest, or 

*AlbumTest to a common interface after it retrieves the bean 


*from the Spring application context. 


Sy 
public interface Test{ 
JEF 
*Runs a simple example 
*/ 


@Transactional (readOnly=false) 
public void run () ; 


} 


这 个 Test 接 口 用 于 为 TestRunner 提 供 一 个 公共 接口 ， 它 也 为 我 们 添 
加 Transactional 标 注 提 供 了 一 种 方便 的 方法 。Transactional 标 注 负 责 将 
一 个 Session 对 象 绑 定 到 当前 线程 ， 启 动 一 个 事务 处 理 ， 如 果 方 法 正常 
返回 ， 则 提交 事务 ， 如 果 有 有 异常 抛 出 ， 则 回 湾 事 务 。 


有 关 @Transactional 标 注 的 更 多 信息 ， 请 参阅 附录 D 。 


如 何 油 活 事务 标注 


为 了 打开 Transactional 标 注 的 处 理 ， 需 要 在 我 们 的 
applicationContext.xml 文 件 中 添加 以 下 一 段 配 置信 息 : 


<! --enable the configuration of transactional behavior based on 
annotations-- > 

<tx: annotation-driven transaction-manager="transactionManager"/ 
> 

<bean id="transactionManager" 

class="org.springframework.orm.hibernate3.HibernateTransactionMa 
nager"> 

<property name="sessionFactory" > 

<ref local="sessionFactory"/> 

</property> 

</bean> 


tx: annotation-driven 元 素 简 单 地 激活 了 Transactional 标 注 ， 将 它 指 
向 一 个 PlatformTransaction-Manager。HibernateTransactionManager 是 
Spring Framework 的 PlatformTransactionManager 接 口 的 一 个 实现 。 它 负 
责 将 来 自 会 话 工厂 的 一 个 Hibernate Session 对 象 用 会 话 工厂 Utils 绑 定 到 
当前 线程 (Thread) 。 因 为 我 们 的 DAO 对 象 都 继承 自 
HibernateDaoSupport， 也 都 使 用 HibernateTemplate， 所 以 这 些 持 久 化 对 
象 就 能 够 参与 到 事务 管理 当中 ， 并 获得 相同 线程 上 的 会 话 对 象 。 这 不 
仅仅 是 因为 事务 处 理 的 需要 ， 在 使 用 延迟 加 载 的 关联 时 ， 它 也 是 必需 
的 。Transactional 标 注 可 以 确保 在 执行 标注 过 的 方法 时 ， 让 同一 会 话 对 
象 保 持 打 开 ， 并 绑 定 到 当前 线程 。 如 果 没 有 这 个 标注 ，Hibernate 就 会 
为 每 个 需要 会 话 的 操作 都 创建 一 个 新 的 会 话 对 象 ， 你 也 天 不 能 取 回 原 
来 用 Hibernate 检 索 到 的 对 象 上 的 任何 关联 。 


为 什么 会 这 样 ? 让 我 们 回顾 一 下 第 5 章 介绍 过 的 主题 。 在 Hibernate 
3 中 ， 映 射 对 象 之 间 的 关联 默认 都 使 用 延 返 加 载 。 除 非 为 某 个 类 或 关联 
显 式 地 改变 这 种 默认 加 载 方式 ， 直 到 你 访问 某 个 特定 对 象 时 ， 才 真正 
从 数据 库 中 检索 相关 联 的 对 象 。 例 如 ， 如 果 从 数据 库 中 检索 回 一 个 
Album 对 象 ， 直 到 你 调用 album.getAlbumTracks () 方法 时 ， 才 会 从 数 
据 库 中 再 检索 回 AlbumTrack 的 List 列 表 对 象 。 为 此 ，Hibernate 要 做 两 
件 事 : 


1.Hibernate 返 回 一 个 “代理 ?对 象 ， 用 于 代表 还 没有 加 载 的 对 象 。 
当 检 索 Track 对 象 时 ， 返 回 的 对 象 是 一 个 Track， 不 过 相关 联 的 集合 
(例如 track.getArtists () ) 则 是 PersistentSet 的 一 个 实例 。 


2.PersistentSet 由 Hibernate 负 责 管理 ， 你 通常 不 需要 考虑 这 一 对 
象 。 与 这 里 的 讨论 相关 的 是 ， 它 是 PersistentCollection 的 一 个 实现 ， 包 
含 了 对 会 话 对 象 的 一 个 引用 。 换 句 话 说， 在 按照 需要 而 获取 相关 联 的 
Artists 时 ， 涉 及 的 是 PersistentSet。 你 可 以 取 回 一 个 Track 对 象 ， 但 是 在 
调用 track.getArtists () 之 前 ， 并 不 会 取 回 任何 Artist 对 象 ， 而 且 即 便 取 
回 关联 的 Artist 对 象 ， 也 得 再 次 通过 会 话 对 象 


只 有 当 PersistentSet 引 用 了 一 个 活动 的 会 话 对 象 时 ， 延 迟 加 载 天 联 
才 有 效果 。 如 果 没 有 一 个 打开 的 会 话 ， 这 时 再 试图 访问 延迟 加 载 的 关 
联 时 ， 就 会 抛 出 一 个 异常 。 在 Web 应 用 程序 中 ， 可 以 使 用 Spring 的 
OpenSessionInViewFilter 之 类 的 东西 来 确保 在 一 个 请 求 中 持 有 对 一 个 会 
话 对 象 的 引用 。 在 这 个 应 用 程序 中 ， 我 们 依靠 Transactional 标 注 来 确保 
run () 方法 实现 的 所 有 代码 都 可 以 访问 到 同一 个 Hibernate 会 话 对 象 。 


调整 CreateTest、QueryTest 以 及 AlbumTest 


现在 我 们 已 经 定义 好 了 Test 接 口 ， 而 且 为 这 个 接口 的 实现 还 建立 
了 一 个 稳定 的 事务 管理 环境 。 接 下 来 整 可 以 修订 我 们 原来 的 


CreateTest、QueryTest 以 及 AlbumTest 类 。 首 先 按 例 13-10 所 示 来 修改 
CreateTest 类 。 


例 13-10: 为 了 在 Spring 中 使 用 而 修改 CreateTest 类 


package com.oreilly.hh; 
import java.sql.Time; 
import java.util.*; 
import com.oreilly.hh.dao.’*; 
import com.oreilly.hh.data.*; 
/** 
*Create sample data, letting Hibernate persist it for us. 
*/ 
public class CreateTest implements Test{ 
private ArtistDAO artistDAO; 
private TrackDAO trackDAO; 
JER 
*Utility method to associate an artist with a track 
*/ 
private static void addTrackArtist (Track track, Artist artist) { 
track.getArtists () .add (artist) ; 
} 
/* (non-Javadoc) 
*@see com.oreilly.hh.Test#run () 
*/ 
public void run () { 
StereoVolume fullVolume=new StereoVolume () ; 
Track track=new Track ("Russian 
Trance", "vol2/album610/track02.mp3", 
Time.valueOf ("00: 03: 30") , new HashSet<Artist> () , new Date 
() 


fullVolume, SourceMedia.CD, new HashSet<String> () ) ; 
addTrackArtist (track, artistDAO.getArtist ("PPK", true) ) ; 
trackDAO.persist (track) ; 

} 

public ArtistDAO getArtistDAO () {return artistDAO; } 
public void setArtistDAO (ArtistDAO artistDAO) { 
this.artistDAO=artistDAO; 

} 

public TrackDAO getTrackDAO () {return trackDAO; } 
public void setTrackDAO (TrackDAO trackDAO) { 

this .trackDAO=trackDAO; 


注意 CreateTest 类 有 两 个 私有 的 成 员 变 量 : artistDAO 和 
trackDAO， 它 们 都 配备 了 作为 bean 属 性 的 访问 器 (accessor) 方法 。 接 
着 ， 按 照 Test 接 口 的 规定 ， 我 们 实现 了 一 个 简单 的 run () 方法 ， 它 最 
终 会 调用 trackDAO.makePersistent () 来 完成 Track 对 象 的 持久 化 。 所 
有 的 处 理 就 是 这 样 的 ， 没 有 try/catch/finally 块 ， 也 没有 涉及 事务 管理 。 
在 DAO 类 的 帮助 下 ， 我 们 差不多 将 所 有 持久 化 处 理 都 交 给 了 Spring 框 
架 。 例 13-11 是 从 applicationContext.xml 摘 取 的 一 段 代 码 ， 该 配置 将 
CreateTest 类 创建 成 一 个 ID 为 createTest 的 bean， 并 将 它 的 artistDAO 和 
trackDAO 属 性 组 装 为 相应 DAO bean 的 引用 。 


例 13-11: 配置 createTest bean 


<bean id="createTest"class="com.oreilly.hh.CreateTest" > 
<property name="trackDAO"ref="trackDAO"/ > 

<property name="artistDAO"ref="artistDAO"/ > 

</bean> 


将 CreateTest 的 这 个 实现 与 例 3-3 的 原始 版 本 进行 比较 ， 你 会 发 现 
它 现 在 已 经 面目 全 非 了 。 非 Spring 版 本 的 CreateTest 类 必须 负责 维护 会 
话 对 象 的 创建 、 事 务 管理 、 异 常 处 理 以 及 配置 。 而 最 新 的 版 本 其 至 连 
会 话 的 影子 也 没有 看 到 。 事 实 上 ， 在 CreateTest 的 最 新 版 本 中 没有 一 点 
Hibernate 特 定 的 东西 DAO 类 让 我 们 的 应 用 程序 的 业务 人 逻辑 不 必 和 直接 
处 理 改 层 的 持久 化 机 制 。 换 句 话 说 ， 在 你 熟悉 了 Spring Framework， 安 


装 好 它 以 后 ， 通 过 Spring 进行 持久 化 要 比 直 接 使 用 Hibernate 容 易 很 
多 。 再 看 看 例 13-12。 


例 13-12: 为 了 在 Spring 中 使 用 而 修改 QueryTest 类 


package com.oreilly.hh; 

import java.sql.Time; 

import java.util.List; 

import org.apache.1log4j.Logger; 

import com.oreilly.hh.dao.TrackDAO; 

import com.oreilly.hh.data. Track; 

SER 

*Retrieve data as objects 

*/ 

public class QueryTest implements Test{ 

private static Logger log=Logger.getLogger (QueryTest.class) ; 
private TrackDAO trackDAO; 

public void run () { 

//Print the tracks that will fit in five minutes 
List <Track>tracks=trackDAO.tracksNoLongerThan ( 
Time.valueOf ("00: 05: 00") ) ; 

for (Track track: tracks) { 

//For each track returned, print out the 

//title and the playTime 

log.info ("Track: \""+track.getTitle () +"\", " 
+track.getPlayTime () ) ; 

} 


} 
public TrackDAO getTrackDAO () {return trackDAO; } 


public void setTrackDAO (TrackDAO trackDAO) { 
this .trackDAO=trackDAO; 


} 
} 
重新 实现 的 QueryTest 也 定义 了 一 个 私有 成 员 变 量 ， 用 于 引用 
TrackDAO 对 象 。run () 方法 调用 trackDAO.tracksNoLongerThan () 
方法 ， 并 为 它 传递 了 一 个 表示 5 分 钟 的 Java.sqlL.Time 类 型 的 变量 。 这 上 段 


代码 循环 访问 查询 结果 ， 用 Log4J 打 印 输 出 Track 对 象 的 title 和 playTime 
属性 。 最 后 看 看 例 13-13。 


例 13-13: 重新 实现 的 AlbumTest 


package com.oreilly.hh; 

import java.sql.Time; 

import java.util.*; 

import org.apache.1log4j.Logger; 

import com.oreilly.hh.dao.*; 

import com.oreilly.hh.data.*; 

SER 

*Create sample album data, letting Hibernate persist it for us. 

*/ 

public class AlbumTest implements Test{ 

private static Logger log=Logger.getLogger (AlbumTest.class) ; 

private AlbumDAO albumDAO; ® 

private ArtistDAO artistDAO; 

private TrackDAO trackDAO; 

public void run () { 

//Retrieve (or create) an Artist matching this name 

Artist artist=artistDAO.getArtist ("Martin L.Gore", true) ; @ 

//Create an instance of album, add the artist and persist it 

//to the database. 

Album album=new Album ("Counterfeit e.p.", 1, 

new HashSet<Artist> () , new HashSet<String> () , 

new ArrayList <AlbumTrack> (5) , new Date () ) ; 

album.getArtists () .add (artist) ; 

album=albumDAO.persist (album) ; © 

//Add two album tracks 

addAlbumTrack (album, "Compulsion", "voli/album83/track01.mp3", 

Time.valueOf ("00: 05: 29") , artist, 1, 1) ; 

addAlbumTrack (album, "In a Manner of Speaking", 

"vyol1/album83/track02.mp3", Time.valueOf ("00: 04: 21") 

artist, 1, 2) ; 

//persist the album 

album=albumDAO.persist (album) ; @ 

log.info (album) ; 

} 

fur 

*Quick and dirty helper method to handle repetitive portion of 
creating 


*album tracks.A real implementation would have much more 
flexibility. 

ar 

private void addAlbumTrack (Album album, String title, String 
file, 

Time length, Artist artist, int disc, 

int positionOnDisc) { 

//Create a new Track object and add the artist 

Track track=new Track (title, file, length, new HashSet <Artist> 


new Date () , new StereoVolume () , SourceMedia.CD, 

new HashSet<String> () ) ; 

track.getArtists () .add (artist) ; 

//Persist the track to the database 

track=trackDAO.persist (track) ; 

//Add a new instance of AlbumTrack with the persisted 

//album and track objects 

album.getTracks () .add (new AlbumTrack (track, disc, 
positionOnDisc) ) ; 


public AlbumDAO getAlbumDAO () {return albumDAO; } 
public void setAlbumDAO (AlbumDAO albumDAO) { 
this .albumDAO=albumDAO; 

} 

public ArtistDAO getArtistDAO () {return artistDAO; } 
public void setArtistDAO (ArtistDAO artistDAO) { 
this.artistDAO=artistDAO; 

} 

public TrackDAO getTrackDAO () {return trackDAO; } 
public void setTrackDAO (TrackDAO trackDAO) { 
this .trackDAO=trackDAO; 

} 

} 


AlbumTest 比 CreateTest 和 QueryTest 都 要 更 复杂 ， 因 为 它 要 处 理 多 
个 对 象 的 创建 和 持久 化 ， 以 及 关联 效果 。 可 以 逐步 看 看 它 的 代码 : 


@ 球 像 CreateTest 和 QueryTest 一 样 ，AlbumTest 类 也 定义 了 一 系列 
私有 字段 来 引用 它 需 要 的 所 有 DAO 对 象 : trackDAO、artistDAO 以 及 
albumDAO ° 


@AlbumTest 首 先 使 用 artistDAO.getArtist () 取 回 一 个 Artist 对 象 
如 果 这 个 方法 没有 找到 请 求 的 艺人 对 象 ， 束 会 创建 一 个 新 的 Artist 对 
象 o 


自持 久 化 Album 实 例 。 这 一 步 会 在 数据 库 中 创建 一 行 数据 ， 并 返 
回 一 个 具有 非 null 值 id 属 性 的 Album 对 象 。 我 们 现在 正在 持久 化 Album 
记录 ， 这 样 就 能 够 使 用 新 的 Album 实 例 来 创建 多 个 Track 对 象 ， 再 把 它 
们 关联 到 这 个 新 的 Ablum 对 象 。 为 了 让 这 一 步 能 够 正常 运行 ， 需 要 确 
保 我 们 的 Album 和 Track 对 象 均 具有 非 null 的 id 属性 。 


@ 接 着 再 增加 一 系列 Track 对 象 。 要 创建 Track 对 象 ， 我 们 首先 创建 
一 个 新 的 Track 实例 ， 再 用 trackDAO.persist () 方法 来 持久 化 该 Track 
对 象 。 在 addAlbumTrack () 方法 中 ， 我 们 创建 了 几 个 Track 对 象 ， 再 
将 它们 与 Album 组 合 起 来 ， 放 到 AlbumTrack 关 系 对 象 中 。Album 上 的 
tracks 必 性 有 一 个 一 对 多 关系 ， 它 的 cascade 属 性 设置 为 
CacscadeType.ALL， 所 以 当 我 们 再 次 持久 化 专辑 对 象 时 ， 它 会 目 动 在 
ALBUM_TRACKS 表 中 创建 相应 的 数据 行 。 


这 就 是 我 们 对 Test 接 口 的 实现 。 所 有 通用 的 处 理 已 经 转换 到 了 所 
有 DAO 的 持久 化 代码 中 ， 接 着 再 把 我 们 单独 的 CreateTest、QueryTest 
以 及 AlbumTest 类 移植 到 其 属性 引用 了 这 些 DAO 的 bean 中 ， 同 时 将 实际 
的 测试 代码 移植 到 Test 接 口 要 求 的 rn () DIEF ° X$, Springin] 


以 将 所 有 这 些 组 件 串 接 在 一 起 。 下 一 太 我 们 将 看 看 如 何 执行 这 些 测 试 


TestRunner: 加 载 Spring ApplicationContext 


如 果 我 们 没 办 法 加 载 Spring 的 ApplicationContext， 并 执行 我 们 的 
Test 对 象 ， 前 面 的 所 有 代码 就 无 法 使 用 。 为 此 ， 我 们 要 创建 一 个 带 有 
static main () 方法 的 TestRunner 类 ， 并 从 我 们 的 Ant build.xml 中 调用 
该 方法 。 例 13-14 完 整地 列 出 了 TestRunner 类 的 内 容 。 这 个 类 负责 加 载 


mr 


我 们 的 Spring ApplicationContext， 取 回 一 个 Test 实 现 ， 并 执行 它 。 


例 13-14: 加 载 Spring ApplicationContext 


package com.oreilly.hh; 

import org.apache.1log4j.Logger; 

import org.apache.1log4j.PropertyConfigurator; 

import org.springframework.context.ApplicationContext; 

import 
org.springframework.context.support.ClassPathXmlApplicationContext; 

JER 

*A simple harness to run our tests.Configures Log4J, 

*creates an ApplicationContext, retrieves a bean from Spring 

*/ 

public class TestRunner{ 

private static Logger log; 

public static void main (String[]args) throws Exception{ 

//Configure Log4J from a properties file 

PropertyConfigurator.configure ( 

TestRunner.class.getResource ("/log4j.properties") ) ; @ 

log=Logger.getLogger (TestRunner.class) ; 

//Load our Spring Application Context 

log.info ("Initializing TestRunnev.....") ; 

log.info ("Loading Spring Configuration.....") ; 

ApplicationContext context=@ 

new ClassPathxXmlApplicationContext ("applicationContext.xml") ; 


//Retrieve the test name from the command line and 
//run the test. 

String testName=args[0]; 

log.info ("Running test: "+testName) ; 

Test test= (Test) context.getBean (testName) ; © 
test.run () ; 


J 


TestRunner 人 负责 为 我 们 做 三 件 事 情 ， 如 JavaDoc 中 所 示 : 


过 引用 类 路 径 的 根 目 孙 下 的 log4j.properties 来 配置 Log4J ° 


@ 使 用 ClassPathXmlApplicationContex 对 象 来 创建 一 个 Spring 的 
ApplicationContext 对 象 。ClassPathXmlApplicationContext 的 构造 函数 接 
受 一 个 字符 串 参 数 ， 用 这 个 参数 来 指明 Spring XML 配置 文件 在 类 路 径 
中 的 位 置 。 在 这 个 例子 中 ， 我 们 的 applicationContextxml 位 于 类 路 径 的 
KAS CAIRGlog4j.properties CF) 。 


日 最 后 ， 我 们 从 命令 行 参数 中 得 到 bean 的 名 称 ， 再 从 
ApplicationContext 中 取 回 相应 的 Test 对 象 。 可 以 看 到 ， 从 
ApplicationContext 中 取 回 特定 名 称 的 bean 古 非常 容易 的 ， 只 需要 调用 
context.getBean (名 称 ) ， 再 将 取 回 的 结果 转换 为 想 要 的 类 型 。 


运行 CreateTest、QueryTest 以 及 AlbumTest 


为 了 运行 TestRunner， 并 从 我 们 的 Spring ApplicationContext 中 取 回 
正确 的 bpean 对 象 ， 还 需要 修改 我 们 的 Ant build.xml 脚 本 。 找 到 名 为 


ctest、dtest 以 及 atest 的 构建 目标 ， 修 改 它 们 以 包含 以 下 XML ， 如 例 13- 
15 所 未 


例 13-15: 从 Ant 中 执行 TestRunner 


<target name="atest"description="Creates and persists some 
album data" 

depends="compile" > 

<java classname="com.oreilly.hh.TestRunner"fork="true" > 

<classpath refid="project.class.path"/> 

<arg value="albumTest"/ > 

</java> 

</target> 

<target name="ctest"description="Creates and persists some 
sample data" 

depends="compile" > 

<java 
classname="com.oreilly.hh.TestRunner"fork="true"failonerror="true" > 

<classpath refid="project.class.path"/> 

<arg value="createTest"/> 

</java> 

</target> 

<target name="qtest"description="Runs a 
query"depends="compile" > 

<java classname="com.oreilly.hh.TestRunner"fork="true" > 

<classpath refid="project.class.path"/> 

<arg value="queryTest"/> 

</java> 

</target> 


TestRunner 类 使 用 它 的 第 一 个 命令 行 参 数 作为 要 从 Spring 
ApplicationContext 获 取 的 bean 的 名 称 。 在 build.xml 中 ， 我 们 在 调用 
TestRunner 时 ， 训 将 bean (applicationContext.xml 中 的 ) 的 名 称 作 为 参 


数 传递 给 它 。 


为 了 创建 测试 数据 库 ， 像 平常 那样 运行 ant schema; 为 了 将 数据 插 
入 到 数据 库 中 ， 则 需要 运行 我 们 新 版 本 的 ant ctest: 


%ant Schema 

%ant ctest 

Buildfile: build.xml 

prepare: 

compile: 

ctest: 

[java]INFO TestRunner: 20-Initializing TestRunnev...... 
[java]INFO TestRunner: 21-Loading Spring Configuration 
[java]INFO TestRunner: 25-Running test: createTest 
BUILD SUCCESSFUL 

Total time: 3 seconds 


运行 ant qtest， 以 调用 新 的 QueryTest 示 例 ， 并 确认 我 们 组 装 起 来 的 
所 有 东西 是 否 可 以 正常 工作 : 


%ant qtest 

Buildfile: build.xml 

prepare: 

compile: 

qtest: 

[java]INFO TestRunner: 20-Initializing TestRunnev...... 

[java]INFO TestRunner: 21-Loading Spring Configuration 

[java]INFO TestRunner: 25-Running test: queryTest 

[java]INFO QueryTest: 25-Track: "Russian Trance", 00: 03: 30 

[java]INFO QueryTest: 25-Track: "Video Killed the Radio Star", 
00: 03: 49 

[java]INFO QueryTest: 25-Track: "Test Tone 1", 00: 00: 10 

BUILD SUCCESSFUL 

Total time: 3 seconds 


最 后 ， 我 们 可 以 运行 新 的 AlbumTest 示 例 。 输 入 ant atest 命 令 ， 你 
尽 该 能 够 看 到 以 下 输出 内 容 : 


%ant atest 

Buildfile: build.xml 

prepare: 

compile: 

atest: 

[java]INFO TestRunner: 16-Initializing TestRunnev..... 
[java]INFO TestRunner: 17-Loading Spring Configuration... 
[java]INFO TestRunner: 21-Running test: albumTest 
[java]INFO AlbumTest: 40-Persisted Album: 1 

[java]INFO AlbumTest: 59-Saved an album named Counterfeit e.p. 
[java]INFO AlbumTest: 60-With 2 tracks. 

BUILD SUCCESSFUL 

Total time: 2 seconds 


HEF, DER BUT A 


Spring Framework 和 Hibernate 彼 此 取长补短 ， 配 合 得 相当 默契 。 如 
果 你 准备 在 一 个 大 型 应 用 程序 中 采用 Hibernate， 则 应 该 考虑 在 Spring 
Framework 的 基础 上 来 构建 你 的 应 用 程序 。 在 你 投入 时 间 学 会 了 这 种 
框架 以 后 ， 我 们 相信 你 会 发 现 为 事务 处 理 、 连 接管 理 以 及 Hibernate 
Session 管 理 而 编写 的 代码 数量 一 定 会 有 所 减少 。 在 这 些 常 规 任务 上 人 花 
费 的 时 间 越 少 ， 就 可 以 投入 更 多 的 时 间 到 你 的 应 用 程序 特定 的 需求 和 
业务 逻辑 处 理 上 。 可 移植 性 (portability) 是 使 用 Spring (或 任何 类 似 
的 IoC 容 器 ) 和 DAO 模 式 的 另 一 个 原因 。 虽 然 Hibernate 是 目前 众多 持 
入 化 库 中 的 首选 ， 但 也 说 不 定 在 未 来 的 10 年 中 又 会 冒 出 什么 新 技术 。 
如 果 你 将 Hibernate 特 定 的 代码 与 应 用 程序 的 其 他 部 分 隔离 开 来 ， 万 一 
要 试验 下 一 种 什么 新 技术 时 ， 就 方便 多 了 。 


JER: Spring 确实 可 以 负责 许多 乏味 的 工作 。 但 这 不 应 该 成 为 我 
们 不 去 学 习 Hibernate 细 贡 的 一 个 借口 。 


当 和 Spring 配合 使 用 时 ， 人 小心 不 要 被 Hibernate 的 简单 性 所 迷惑 。 
本 书 的 几 位 作者 一 致 同意 ， 虽 然 Hibernate 是 一 件 非常 好 的 东西 ， 但 有 
时 也 会 因为 某 些 原因 而 很 难 调试 和 诊断 Hibernate; 输入 错 了 的 一 个 字 
符 、 没 有 正确 映射 的 数据 表 、 稍 微 不 正 确 的 ftush (刷新 ;模式 或 者 是 
本 
得 容易 ， 是 因为 它 提 供 了 一 些 实用 的 抽象 ， 让 你 的 操作 变 得 更 简单 。 
但 是 这 样 的 简单 性 减少 了 需要 直接 在 数据 库 中 执行 SQL 语句 的 机 会 ， 
让 你 更 加 脱离 底层 细 节 。 虽 然 你 可 能 不 必 目 己 编写 事务 处 理 代 码 ， 但 
在 遇 到 问题 时 ， 这 些 抽象 也 让 你 更 难 诊断 出 产生 错误 的 根本 原因 。 不 
要 误解 ， 我 是 不 会 脱离 Spring 而 单独 使 用 Hibernate 的 ， 但 是 如 果 你 牢 
固 地 掌握 好 了 Hibernate 的 底层 细节 ， 那 么 就 能 更 快 地 诊断 出 问题 是 出 
在 了 哪儿 。 


在 下 一 章 ， 我 们 将 向 你 展示 更 高 级 的 技术 一 如 何 将 Hibernate 集 成 
到 一 个 称 为 Stripes 的 Web 应 用 程序 框架 中 。 在 这 个 Web 程 序 框架 中 ， 你 
将 看 到 如 何 将 Spring 作为 Stripes 和 Hibernate 之 间 一 个 中 立 的 代理 。 在 你 
阅读 学 习 下 一 章 时 ， 你 应 该 牢记 一 个 事实 : 目前 使 用 的 大 多 数 流行 的 
Web 应 用 程序 框架 都 提供 了 与 Spring 直接 集成 的 某 种 功能 。 如 果 你 使 用 
的 是 Struts 2、Wicket 或 者 Spring MVC， 它 们 中 的 许多 概念 是 相同 的 。 


Spring 是 软件 的 Rosetta.Stone (ŽU) ， 在 你 接受 它 以 后 ， 就 可 以 访问 
为 与 Spring 集成 而 设计 的 所 有 开发 库 。 以 Spring 作为 基石 ， 你 就 可 以 随 
着 需求 的 改变 而 更 容易 地 在 不 同 技术 之 间 进 行 转换 。 比 如 ， 不 用 

Java， 而 是 用 JRuby 或 Groovy 来 编写 DAO 组 件 ， 使 用 Quartz 来 集成 cron- 
like 表 达 式 ; 以 及 使 用 像 Apache CXF 之 类 的 库 将 服务 对 象 发 布 为 SOAP 


服务 端点 等 。 


[1] 美国 Rosetta Stone ( 罗 赛 塔 石碑 语言 学 习 软 件 ) 是 风靡 世界 的 多 媒 
体 英 语 教 学 软件 。 


第 14 章 ”画龙点睛 : 用 Stripes 集 成 Spring 和 


Hibernate 


在 最 近 的 几 年 中 ， 各 种 Java Web 框 架 如 雨后春笋 快速 兴起 。 过 去 
一 段 时 间 内 ，Struts 被 认为 是 事实 上 的 Web 应 用 程序 的 Java 框 架 ， 但 现 
在 人 们 意识 到 还 有 各 种 选择 可 以 使 用 。Java Server Faces (JSF) 在 企 
业 空 间 中 占有 一 定 的 份额 ，Spring MVC 随 Spring Framework 也 安装 到 
许多 应 用 中 ， 不 过 ， 发 现 Stripes 的 开发 人 员 也 会 经 常 选择 这 种 框架 。 
Stripes 的 知名 度 昌 然 没 有 Spring 那么 大 ， 但 是 众所周知 ， 市 场 成 功 并 不 
总 是 直接 由 品质 决定 的 。Stripes 就 是 那 种 默默 无 闻 ， 却 义 做 出 了 很 多 
非 同 寻常 的 成 果 的 项 目 之 一 。 


如 果 你 对 某 种 Web 开 发 框架 很 有 经 验 ， 可 能 会 注意 到 有 很 多 方法 
可 以 将 Java 代 码 和 URL 以 及 表单 提交 绑 定 起 来 。 这 些 方法 中 的 大 多 数 
都 需要 用 复杂 的 XML 和 Java 代 码 来 做 些 非 同 寻常 的 处 理 ， 它 们 如 此 复 
杂 和 难以 使 用 ， 以 至 于 很 多 人 放弃 使 用 Java 作 为 Web 应 用 程序 的 开发 
工具 ， 因 为 这 将 以 牺牲 实现 速度 作为 代价 。 放 弃 Java 框 染 ， 也 束 错 过 
了 已 经 用 Java 开 发 的 众多 优秀 的 开发 框 染 ， 也 与 这 种 功能 丰富 的 开发 
语言 失之交臂 。 我 们 的 感觉 是 Java 提 供 的 东西 非常 多 ， 然 而 Stripes 通 
过 充分 利用 Java 的 功能 和 一 致 的 体系 结构 ， 解 除了 以 往 Java Web 开 发 
中 的 诸多 痛 碧 。 虽 然 大 多 数 开 发 人 员 会 有 更 好 的 决断 ， 但 Struts 在 相当 


长 的 一 段 时 间 内 垄断 了 Java Web 框 架 。Tim Fennell 之 所 以 要 创建 
Stripes， 就 是 为 了 取代 Struts Web 框 架 ， 因 为 他 不 喜欢 将 所 有 东西 都 放 
在 struts-config.xml 中 ， 更 不 喜欢 为 了 完成 简单 的 任务 还 得 管理 很 多 配 
置 文件 (由) 。 他 以 Java 5 和 Servlet 2.4 作 为 项 目的 起 点 ， 就 能 够 对 
Java Web 开 发 的 现状 进行 一 定 的 改进 。 对 于 原来 Struts 中 大 部 分 公 琐 的 
任务 ，Stripes 则 通过 合理 的 默认 值 、 反 射 (reflection) 、 标 注 、 基 于 
泛 型 的 类 型 推导 (type inference) 来 加 以 简化 。 结 果 ，Stripes 就 成 为 一 
种 简洁 、 易 于 理解 和 扩展 的 开发 框架 ， 让 Java Web 开 发 变 成 了 一 件 有 
趣 的 事 。 


&2Stripes 


Stripes ('7!) 的 目标 就 是 要 简化 开发 人 员 的 生活 。 为 此 ， 对 
配置 提出 一 定 的 约定 ， 当 应 用 程序 广泛 使 用 默认 设置 时 ， 也 有 办 法 可 
以 修改 这 些 默认 设置 。 就 像 在 前 面 介 绍 Spring 的 那 章 一 样 ， 我 们 并 不 
打算 完整 地 介绍 Stripes 为 开发 人 员 提 供 的 所 有 友好 的 功能 ， 只 是 希望 
你 可 以 通过 我 们 的 介绍 而 明白 Stripes 是 什么 ， 以 及 如 何 让 它 同 Spring 和 
Hibernate 协 同 工 作 。 作 为 开始 ， 最 好 是 先 了 解 几 个 与 Stripes 应 用 程序 
有 关 的 概念 。 虽 然 你 只 需要 负责 与 ActionBean 和 视图 打交道 ， 也 应 该 
明白 Stripes 实 现 的 DispatcherServlet 和 StripesFilter 的 工作 原理 。 


Wee 


DispatcherServlet 


在 Stripes 应 用 程序 中 ， 通 常 只 有 一 个 J2EE HttpServlet 接 口 的 实 
现 ， 由 Stripes 的 Dispatcher-Servlet 为 你 提供 这 个 实现 。DispatcherServlet 
监听 到 来 的 URL 请 求 ， 再 决定 应 该 实例 化 哪个 ActionBean， 以 及 应 该 
调用 那个 ActionBean 上 的 什么 方法 。 可 以 将 Dispatcher 看 做 是 应 用 程序 
的 “管理 器 ”。 当 请 求 到 达 应 用 程序 时 ，Dispatcher 会 检查 请 求 ， 再 决定 
应 该 将 这 个 请 求 委 托 给 程序 的 哪 部 分 负责 处 理 。 按 照 约定 ， 一 般 将 
DispatcherServlet 有 映射 到 *.action URL ° 


StripesFilter 


StripesFilter 封 装 了 程序 要 处 理 的 所 有 HTTP 请 求 。 当 直接 请 求 一 个 
JSP 时 ，StripesDispatcher 吏 不 会 有 机 会 运行 ， 这 时 就 得 由 StripesFilter 
负责 为 JSP 和 ActionBean 提 供 一 些 Stripes 的 特定 功能 ， 二 者 的 处 理 方式 
差不多 是 一 样 的 。StripesFilter 可 以 执行 对 multipart 类 型 的 表单 的 处 
理 、 本 地 化 选择 、flash scope 管 理 (1!) 以 及 last stop 异 常 处 理 。 


ActionBean 


当 编 写 ActionBean 时 ， 束 可 以 真正 看 到 Stripes 的 可 贵 之 处 。 
接口 只 需要 为 一 个 名 为 context 的 属性 配备 一 个 getter 和 setter 方 法 ， 
context 将 是 ActionBeanContext 的 一 个 实例 。DispatcherServlet 使 用 
ActionBean 上 的 反射 ， 以 及 HTTP 请 求 参 数 和 ActionBean 中 的 标注 ， 驶 
可 以 决定 应 该 运行 什么 方法 。 


除了 setContext () 和 getContext () 方法 ，ActionBean 还 可 以 包含 
几 个 返回 Resolution 的 方法 ， 以 及 用 于 同 视图 进行 交互 的 属性 存 取 器 
(accessor) 。 稍 后 我 们 开始 构建 示例 时 ， 你 就 会 明白 这 里 说 的 这 些 概 
念 是 什么 意思 了 “。 你 的 ActionBean 不 必 进 行 类 似 
HttpRequest.getParameter () 之 类 的 调用 ， 因 为 Stripes 可 以 自动 负责 将 
请 求 参 数 绑 定 到 对 象 。 


视图 


Stripes 使 用 JSP 作 为 它 的 视图 技术 。 当 ActionBean 将 请 求 转发 到 
JSP 时 ，Stripes 会 为 JSP 提 供 一 个 对 该 ActionBean 的 引用 ， 以 便 可 以 用 
JSTL 表 达 式 语言 来 取出 ActionBean 中 的 数据 。 反 之 ， 在 JSP 中 可 以 用 
useActionBean 标 签 来 调用 某 个 ActionBean 的 事件 处 理 器 ， 以 便 为 显示 
准备 请 求 (例如 通过 格式 化 属性 ) 。Stripes 也 提供 了 一 个 简单 的 JSP 标 
签 库 ， 来 帮助 链接 应 用 程序 的 各 个 部 分 和 提供 表单 。 


[1] Æ WL http://stripesframework.org/display/stripes/Stripest+vs.+Struts. 

[2] http://stripesframework.org/. 

[3] flash scope 是 一 个 概念 ， 其 本 质 是 临时 储存 一 些 属性 给 (并 且 仪 
给 ) 下 一 个 请 求 使 用 ， 使 用 过 后 便 被 清除 掉 。 


准备 Tomcat 


我 们 假设 你 已 经 有 了 一 个 可 以 跑 起 来 的 Apache Tomcat 环 境 ， 还 需 
要 确保 拥有 Tomcat 环 境 的 manager (管理 员 ) 角色 的 用 户 喘 份 。 可 以 修 
改 这 些 安全 配置 的 地 方 是 $CATALINA_HOME/conf/tomcat-users.xml， 
请 按 例 14-1 所 示 的 内 容 来 调整 你 的 tomcat-users.xml 文 件 。 


例 14-1: 在 tomcat-users.xml 中 定义 一 个 manager 角 色 


<?xml version='1.0'encoding='utf-8'?> 

<tomcat-users=> 

<role rolename="manager"/> 

<role rolename="tomcat"/> 

<role rolename="role1"/> 

<user username="tomcat"password="tomcat"roles="tomcat, 
manager"/ > 

<user username="both"password="tomcat"roles="tomcat, rolei"/> 

<user username="role1"password="tomcat"roles="role1"/> 

</tomcat-users> 


如 宁 在 tomcat-users.xml 中 新 添加 了 一 个 manager 角 色 ， 则 需要 保存 
该 文件 ， 并 重新 启动 Tomcat。 接 下 来 束 可 以 开始 创建 Stripes 应 用 程序 
T o 


创建 Web 应 用 程序 


既然 Tomcat 实 例 已 经 可 以 跑 起 来 了 ， 接 下 来 就 开始 创建 一 个 Web 应 
用 程序 。 首 先 ， 要 在 你 的 项 目 目录 中 为 我 们 的 Web 应 用 程序 创建 目录 结 
构 ， 如 例 14-2 所 示 。 你 可 以 自己 手工 创建 这 个 目录 ， 也 可 以 从 本 书 的 网 
站 下 载 代码 示例 。 


例 14-2: 创建 Web 应 用 程序 目录 结构 的 命令 


$mkdir-p webapp/WEB-INF 


作为 开始 ， 我 们 要 在 应 用 程序 中 加 入 一 个 web.xml 和 index.jsp 文 
件 ， 并 部 署 它们 。 每 个 J2EE Web 应 用 程序 都 需要 一 个 web.xml 文 件 ， 所 
以 我 们 就 和 完 从 这 儿 开始 。 稍 后 我 们 再 用 Filter 和 Servlet 标 等 来 配置 这 个 
文件 ， 不 过 现在 束 把 这 个 只 有 空 架子 的 web.xml 文 件 放 在 webapp/WEB- 
INF 中 了 ， 如 例 14-3 所 示 。 


例 14-3: 最 简单 的 webapp/WEB-INF/web.xml 文 件 


<?xml version="1.0"encoding="UTF-8"?> 

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 

xmins: xsi="http://www.w3.org/2001/XMLSchema- instance" 

XSi: schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"version="2.4"> 
</web-app> 


一 个 Web 应 用 程序 至 少 要 有 一 个 视图 供用 户 查 看 ， 所 以 我 们 先 在 应 
用 程序 的 根 目 录 (webapp) 下 添加 一 个 非常 简单 的 index.jsp 文 件 。 再 
一 次 ， 我 们 还 不 准备 搞 些 花 哨 的 风格 样式 ， 我们 只 需要 页 面 上 能 有 些 
内 容 ， 好 让 我 们 知道 有 东西 在 运行 束 可 以 了 。 代 码 如 例 14-4 所 示 。 


例 14-4: 一 个 简单 的 JSP 文 件 webapp/index.jsp 


<?xml version="1.0"?> 
<%@page contentType="text/html; charset=UTF-8"language="java"%> 
Hello World 


目前 将 应 用 程序 部 嗜 到 Tomcat 有 许多 种 方法 ， 你 可 以 随意 使 用 你 
喜欢 的 任何 方法 。 我 比较 喜欢 用 Ant deploy (部 署 ) 构建 任务 将 上 下 文 
信息 发 送 到 Tomcat。 在 应 用 程序 上 下 文 配置 文件 中 可 以 指定 docBase， 
告诉 Tomcat 到 哪儿 去 找 开 发 位 置 上 的 应 用 程序 。 采 用 这 种 部 署 技巧 ， 
你 只 需要 部 署 一 次 应 用 程序 。 将 程序 部 署 到 Tomcat 可 能 会 化 不 少时 
间 ， 所 以 与 每 次 都 需要 部 署 程序 相 比 ， 采 用 这 种 办 法 以 后 ， 你 的 编译 
和 测试 周期 将 会 变 得 更 快 。 


为 了 运行 应 用 程序 ，Tomcat 还 需要 知道 一 些 与 之 相关 的 信息 。 为 
Tomcat 提 供 信息 的 一 种 方法 丈 是 将 这 些 信息 放 在 context 文 件 中 (如 例 
14-5 所 示 ) 。 我 们 需要 让 Tomcat 知 道 的 主要 事情 就 是 应 用 程序 的 位 置 。 


例 14-5: 一 个 tomcat-context.xml 文 件 的 例子 


<?xml version="1.0"?> 

<Context 
docBase="/home/rfowler/current/examples/ch14/webapp"@ 
debug="0" 

reloadable="true"@ 

> 

</Context > 


@docBase 属 性 用 于 指定 应 用 程序 将 位 于 Tomcat 服 务 器 的 文件 系统 
的 哪个 位 置 。 你 需要 将 这 个 属性 修改 为 你 的 计算 机 中 应 用 程序 的 实际 
位 置 。 


@Context 的 reloadable 属 性 用 于 指定 Tomcat 是 否 应 该 监视 应 用 程序 
类 文件 的 变化 ， 并 在 有 变化 时 重新 加 载 应 用 程序 的 上 下 文 。 打 开 重 新 
加 载 可 以 方便 我 们 的 开发 周期 ， 但 是 当 应 用 程序 发 布 为 产品 以 后 ， 则 
会 浪费 一 定 的 CPU 周期 。 


现在 ， 我 们 已 经 编写 好 了 一 个 context 文 件 ， 接 下 来 就 更 新 build.xml 
文件 ， 以 便 可 以 部 署 应 用 程序 。 在 本 章 的 构建 文件 中 还 需要 添加 几 个 
依赖 文件 ， 我 们 打算 将 所 有 的 修改 内 容 都 一 次 性 复制 到 这 里 ， 如 例 14-6 
rae 


例 14-6: build.xml F TANJA Tomcat 


<artifact: dependencies pathId="dependency.class.path" 

filesetid="dependency.fileset" > 

<dependency 
groupId="hsqldb"artifactId="hsqldb"version="1.8.0.7"/> 

<dependency groupId="mysql"artifactId="mysql-connector-java" 

version="5.0.5"/> 


<dependency groupId="org.hibernate"artifactId="hibernate" 

version="3.2.5.ga"> 

<exclusion groupId="javax.transaction"artifactId="jta"/> 

</dependency > 

<dependency groupId="org.hibernate"artifactId="hibernate-tools" 

version="3.2.0.beta9a"/ > 

<dependency groupId="org.apache.geronimo.specs" 

artifactId="geronimo-jta_1.1_spec"version="1.1"/> 

<dependency groupId="log4j"artifactId="log4j"version="1.2.14"/> 

<dependency 
groupId="javax.servlet"artifactId="jstl"version="1.1.1"/> 

<dependency 
groupiId="taglibs"artifactId="standard"version="1.1.1"/> 

<dependency groupId="org.hibernate"artifactId="hibernate- 
annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.hibernate" 

artifactId="hibernate-commons-annotations" 

version="3.3.0.ga"/> 

<dependency groupId="org.springframework"artifactId="spring" 

version="2.5"/> 

<dependency groupId="commons-dbcp"artifactId="commons-dbcp" 

version="1.2.2"/> 

<dependency 
groupId="net.sourceforge.stripes"artifactId="stripes" 

version="1.4.3"/>@ 

<dependency groupId="tomcat"artifactId="servlet- 
api"version="5.5.12"/>@ 

<dependency groupId="tomcat"artifactId="catalina-ant" 

version="5.5.15"/>®6 

<dependency groupId="tomcat"artifactId="jasper-compiler" 

version="5.5.15"/> 

<dependency groupId="tomcat"artifactId="jasper -runtime" 

version="5.5.15"/>@ 

</artifact: dependencies > 


@Stripes 这 个 artifact 配 置 提供 了 使 用 Stripes 框 架 所 需要 的 jar 库 。 


@servlet-api 这 个 artifact 配 置 提 供 了 包含 J2EE Servlet 接 口 和 文 持 类 
的 库 。HttpServletRequest 和 HttpServletResponse 类 都 是 由 这 个 artifact 提 
供 的 。 


@catalina-ant artifact Id 提供 了 一 些 用 于 同 运行 的 Apache Tomcat 实 
例 进行 交互 的 Ant 构 建 任务 。 简 单 来 说 ， 你 将 在 构建 文件 中 增加 一 个 新 
的 构建 目标 ， 它 会 用 到 来 自 这 个 artifact 的 Tomcat 的 deploy 构 建 任 务 。 


@jasper-compiler 和 jasper-runtime 这 两 个 artifact， 除 了 catalina-ant 以 
外 ，Tomcat 的 deploy 标 签 也 需要 它们 。 


到 这 以 后 ， 下 一 步 就 是 用 taskdef 建 立 Catalina Ant 构 建 任 务 ， 为 部 
署 应 用 程序 定义 一 个 新 的 target。Ant 的 deploy 构 建 任务 将 为 Tomcat 发 送 
一 个 tomcat-context.xml 文 件 〈 例 14-5) ， 包 括 身 份 认证 信息 和 context 路 

如 例 14-7 所 示 。 


例 14-7: 用 于 部 署 应 用 程序 的 Ant 构 建 目标 


<taskdef name="hibernatetool" 
classname="org.hibernate.tool.ant.HibernateToolTask" 
classpathref="project.class.path"/> 

<! --Teach Ant how to use Tomcat's deploy task--> 

<taskdef name="deploy"classpathref="dependency.class.path" 
classname="org.apache.catalina.ant.DeployTask"/ > 

<target name="db"description="Runs HSQLDB database management UI 
against the database file--use when application is not running"> 
<java classname="org.hsqldb.util.DatabaseManager" 

fork="yes"> 

<classpath refid="project.class.path"/> 

<arg value="-driver"/> 

<arg value="org.hsqldb.jdbcDriver"/> 

<arg value="-url"/> 

<arg value="jdbc: hsqldb: ${data.dir}/music"/> 

<arg value="-user"/> 

<arg value="sa"/> 

</java> 

</target> 


<target name="qtest3"description="Retrieve all mapped objects" 

depends="compile" > 

<java 
classname="com.oreilly.hh.QueryTest3"fork="true"failonerror="true" > 

<classpath refid="project.class.path"/> 

</java> 

</target> 

<target name="deploy"> 

<deploy url="http://localhost: 8080/manager"® 

username="tomcat"password="tomcat"®@ 

path="/stripesapp"® 

config="${basedir}/tomcat-context.xml"/>® 

</target> 


@deploy 构 建 任 务 的 url 属 性 用 于 指定 Apache Tomcat 提 供 的 manager 


servletHJURL ° 


@username 和 password 属 性 指定 管理 豆角 色 的 用 户 号 份 验证 信息 ， 
这 些 信息 是 在 例 14-1 中 配置 的 。 


@path 属 性 告诉 Tomcat， 应 用 程序 应 该 部 署 到 什么 上 下 文 路 径 。 


@config 属 性 指定 将 要 发 送 到 Tomcat 的 上 下 文 文件 。 这 个 文件 如 例 


14-5 所 示 。 


所 有 安排 妥当 以 后 ， 就 应 该 可 以 运行 ant deploy 命 令 (如 例 14-8 所 
示 ) ， 再 在 Web 浏 览 器 中 访问 我 们 简单 的 Web 应 用 程序 了 。 


例 14-8: 部 署 应 用 程序 


$ant deploy 
Buildfile: build.xml 


deploy: 

[deploy]0K-Deployed application at context path/stripesapp 
BUILD SUCCESSFUL 

Total time: 3 seconds 


上 面 示例 输出 中 的 "OK" 表 示 Tomcat 已 经 接受 了 新 的 应 用 程序 。 在 
浏览 器 中 访问 http://localhost: 8080/stripesapp， 看 看 这 个 程序 是 否 存 
在 ， 运 行 的 对 不 对 。 在 默认 情况 下 ，Tomcat 将 会 查找 和 返回 Web 应 用 程 
序 根 目录 下 的 index.jsp 文 件 。 因 此 ， 应 用 程序 应 该 在 浏览 器 中 显 
示 "Hello World"， 如 图 14-1 所 示 。 
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Al 14-1 Tomcat 显 示 "Hello World" 
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虽然 我 们 刚才 进行 的 所 有 任务 和 Stripes 或 Hibernate 没 有 任何 关系 ， 
但 是 这 些 操作 为 使 用 Stripes 铺 平 了 道路 。 现 在 我 们 有 了 一 个 可 以 跑 起 来 
的 Apache Tomcat 安 闭 实 例 ， 以 及 一 个 我 们 目 己 创建 的 运行 民 好 的 Web 
应 用 程序 了 。 


增加 Stripes 


为 了 让 我 们 的 项 目 可 以 在 Web 环 境 中 运行 ， 需 要 对 compile 构 建 任 
务 进行 一 些 修改 。 到 现在 为 止 ， 我 们 一 直 在 用 Ant 来 局 动 应 用 程序 ， 所 
以 要 为 Ant 提 供 正 确 的 代码 类 路 径 信息 。 目 前 一 切 运 行 正常 ， 但 是 
Tomcat 的 类 加 载 管理 机 制 要 复杂 得 多 ， 因 此 ， 将 所 有 需要 的 依赖 文件 
直接 复制 到 应 用 程序 的 WEB-INF/lib 目 录 下 是 最 简单 的 方法 。 我 们 也 和 希 
望 编译 任务 可 以 将 文件 放 在 WEB-INF 中 ， 这 样 Tomcat 就 可 以 直接 找到 
它们 。 参 见 例 14-9。 


例 14-9: 针对 Web 应 用 程序 而 修改 Compile 构 建 任务 


<property name="source.root"value="src"/> 

<property name="class.root"value="webapp/WEB-INF/classes"/>@ 
<property name="data.dir"value="webapp/WEB-INF/data"/>@® 
<target name="compile"depends="prepare" 

description="Compiles all Java classes"> 

<javac srcdir="${source.root}" 

destdir="${class.root}" 

debug="on" 

optimize="off" 

deprecation="on"> 

<classpath refid="project.class.path"/> 

</javac> 

<filter token="docroot"value="${basedir}/webapp"/>® 

<copy todir="webapp/WEB-INF"filtering="true"overwrite="true"> 
<fileset dir="src"includes="applicationContext.xml"/> 
</copy> 0 

<copy todir="webapp/WEB-INF/lib"flatten="true"> 

<fileset refid="dependency.fileset"/> 

</copy> © 


</target> 
@ 因 为 我 们 正在 将 应 用 程序 移植 到 J2EE Web 应 用 程序 ， 所 以 需要 
把 Java 类 放 到 webapp/WEB-INF/classes 目 录 下 。 最 简单 的 实现 方法 就 是 
修改 class.root 属 性 值 。 


@ 由 于 当前 的 工作 目录 还 不 能 确定 ， 所 以 HSQLDB 也 不 能 够 在 数 
据 的 相对 路 径 中 找到 数据 库 。 因 此 ， 我 们 需要 为 Hibernate 提 供 数据 库 
的 完整 路 径 。 为 此 ， 创 建 一 个 data.dir 属 性 ， 当 复制 
applicationContext.xml 文 件 时 会 用 到 这 个 属性 。 


@ant 的 filter 构 建 任务 指定 当 复制 applicationContext.xml 上 时， 需要 用 
Web 应 用 程序 的 实际 路 径 来 蔡 换 @docroot@ 标 记 。 


@ 需 要 将 Spring 的 applicationContext.xml 文 件 复制 到 webapp/WEB- 
INF 目 录 下 ， 以 便 Tomcat 可 以 找到 它 。 


既然 应 用 程序 不 再 由 Ant 来 启动 了 ， 我 们 也 就 不 能 再 依赖 本 地 
Maven 仓 库 中 找到 的 Java 库 。J2EE 规 范 要 求 把 Web 应 用 程序 的 JAR 文 件 
放 到 WEB-INF/Nib 目 录 中 ， 所 以 这 一 步 就 是 将 我 们 需要 的 文件 从 Maven 
本 地 仓库 复制 到 WEB-INF/Nib 目 录 中 。 


为 了 让 用 docroot 配 置 的 过 滤器 (filter) WEA A SAAR, Fer] 
需要 在 src/application-Context.xml (第 13 章 中 创建 的 ) 中 添加 


@docroot@ 标 记 ， 例 14-10 演 示 了 这 一 修改 。 


例 14-10: applicationContext.xml 中 数据 库 配 置 文件 位 置 的 变化 


<property name="hibernateProperties" > 

<props > 

<prop key="hibernate.show_sql" >true</prop> 

<prop key="hibernate.format_sql">true</prop> 

<prop key="hibernate.transaction.factory_class">org.hibernate. 

transaction. JDBCTransactionFactory</prop> 

<prop key="hibernate.dialect">org.hibernate.dialect .HSQLDialect 
</prop> 

<prop key="hibernate.connection.autocommit">false</prop> 

<prop key="hibernate.connection.release_mode">after_transaction 
</prop> 

<prop key="hibernate.connection. shutdown" >true</prop> 

<prop key="hibernate.connection.driver_class"> 
org.hsqldb.jdbcDriver 

</prop> 

<prop key="hibernate.connection.url">jdbc: hsqldb 
@docroot@/WEB - INF 

/data/music </prop> 

<prop key="hibernate.connection.username" >sa</prop> 

<prop key="hibernate.connection.password" > </prop> 

<prop key="hibernate.current_session_context_class">thread 
</prop> 

<prop key="hibernate.jdbc.batch_size" >0</prop> 

</props> 

</property> 


现在 ， 我 们 的 构建 环境 已 经 修改 好 ， 可 以 开始 使 用 Stripes 了 “。 为 了 
让 Spring、Hibernate 以 及 Stripes 协 同 工 作 ， 还 需要 对 web.xml 进 行 多 处 修 
改 。 例 14-11 中 演示 了 很 多 内 容 ， 但 每 个 配置 项 都 有 一 定 的 作用 。 稍 后 
将 介绍 一 下 其 中 重要 的 配置 。 


例 14-11: 针对 Stripes 集 成 而 修改 后 的 web.xml 


<?xml version="1.0"encoding="UTF-8"?> 

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 

xmlns: xsi="http://www.w3.org/2001/XMLSchema- instance" 

xsi: schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" 
version="2.4"> 

<listener > 

<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class>@ 

</listener > 

<context -param> 

<param-name > contextConfigLocation</param-name > 
<param-value > /WEB-INF/applicationContext.xml</param-value > 
</context -param> 

<! --Hibernate OpenSession Filter--> 

<filter> 

<filter-name>hibernateFilter</filter-name>@ 
<filter-class> 
org.springframework.orm.hibernate3.support.OpenSessionInViewFilte 


</filter-class> 

<init-param> 
<param-name > singleSession< /param-name > 
<param-value>true</param-value > 

</init -param> 

<init-param> 

<param-name > sessionFactoryBeanName < /param-name > 
<param-value>sessionFactory </param-value > 
</init -param> 

<init-param> 
<param-name > flushMode < /param-name > 
<param-value > ALWAYS< /param-value > 
</init-param> 

</filter> 

<filter> 

<display-name>Stripes Filter</display-name>® 
<filter-name>StripesFilter </filter-name> 
<filter-class> 
net.sourceforge.stripes.controller.StripesFilter 
</filter-class> 

<init-param> 

<param-name > ActionResolver .PackageFilters</param-name > 
<param-value>com.oreilly.*</param-value> 


</init-param> 

<init-param> 

<param-name >ActionResolver .UrlFilters</param-name> 
<param-value >WEB-INF/classes </param-value > 
</init-param> 

<init-param> 

<param-name > Interceptor .Classes</param-name > 
<param-value> 
net.sourceforge.stripes.integration.spring.SpringInterceptor, 
net.sourceforge.stripes.controller .BeforeAfterMethodInterceptor 
</param-value> 

</init-param> 

</filter> 

<filter -mapping> 

<filter-name>hibernateFilter </filter-name> 
<url-pattern>*.jsp</url-pattern> 

<dispatcher > REQUEST < /dispatcher > 
</filter-mapping> 

<filter -mapping> 
<filter-name>hibernateFilter</filter-name> 
<url-pattern>*.action</url-pattern> 

<dispatcher > REQUEST < /dispatcher > 
</filter-mapping> 

<filter -mapping> 

<filter-name>StripesFilter </filter-name> 
<url-pattern>*.jsp</url-pattern> 

<dispatcher > REQUEST < /dispatcher > 
</filter-mapping> 

<filter -mapping> 

<filter-name>StripesFilter </filter-name> 
<url-pattern>*.action</url-pattern> 

<dispatcher > REQUEST < /dispatcher > 
</filter-mapping> 

<servlet > 

<servlet-name >StripesDispatcher </servlet-name>@® 
<servlet-class> 
net.sourceforge.stripes.controller .DispatcherServlet 
</servlet-class> 
<load-on-startup>1</load-on-startup> 

</servlet > 

<servlet-mapping> 

<servlet-name >StripesDispatcher </servlet -name > 
<url-pattern>*.action</url-pattern> 

</servlet -mapping > 

</web-app > 


@ContextLoaderListener 过 滤器 用 于 初始 化 Web 应 用 程序 的 Spring 


Framework ° 


@hibernateFilter= H Springe FEA), FAT AKER — Sta TPA TK 
处 理 的 Hibernate 会 话 。 使 用 这 个 功能 ， 我 们 就 可 以 不 必 再 自己 管理 
Hibernate 会 话 。 这 一 功能 之 所 以 精彩 ， 是 因为 正确 的 会 话 管理 可 能 是 
编写 支持 Hibernate 的 Web 应 用 程序 时 最 具 技 巧 性 的 处 理 之 一 。 


© Jf Stripes Filter 映 里 到 *.action 和 *.jsp HTTP 请 求 。 它 提供 了 调用 
JSP 或 ActionBeans 时 所 需 的 一 些 基本 表单 处 理 和 配置 服务 。 


@StripesDispatcher servlet 映 射 到 了 *.action， 负 责 决 定 应 该 调用 哪 
个 ActionBean 中 的 哪个 方法 ， 以 及 处 理由 这 些 事件 方法 返回 的 
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图 14-2 Stripes 下 载 页 面 


在 开始 使 用 Stripes 以 前 ， 为 了 让 它 正常 运行 ， 还 有 最 后 一 个 需要 安 
装 的 配置 。Stripes-Resources.properties 文 件 位 于 classes 类 目录 中 ， 它 为 
Stripes 提 供 一 些 必需 的 格式 化 字符 串 。 对 于 这 个 例子 来 说 ， 最 简单 的 办 
法 就 是 用 下 载 的 随 书 示例 代码 ， 直 接 从 examples/ch14/src 目 杂 中 复制 
StripesResources.properties 文 件 ， 不 过 也 可 以 从 Stripes 下 载 包 (1H) 中 
得 到 这 个 文件 。 在 Stripes 1.4.3 下 载 页 面 的 中 间 ， 点 击 "Download" 按 
钮 ， 如 图 14-2 所 示 ， 继 续 链接 到 SourceForge 下 载 页 面 ， 对 SourceForge 
我 们 都 应 该 很 熟悉 了 。 在 下 载 好 stripes-1.4.3.zip 以 后 ， 将 它 进行 解压 ， 
再 把 stripes-1.4.3/lib/StripesResources.properties 复 制 到 你 的 src 目 录 下 。 如 


果 愿 意 ， 你 可 以 看 看 这 个 文件 的 内 容 ， 不 过 它 只 是 本 章 示例 需要 的 一 
个 依赖 义 件 而 已 。 


最 后 就 应 该 编写 一 点 代码 了 。 首 先 ， 我 们 来 编写 两 个 JSP 文 件 ， 再 
接着 开发 一 个 ActionBean。 如 果 你 最 近 几 年 写 过 些 JSP 人 代码， 那么 我 们 
在 这 儿 编 写 的 JSP 文 件 也 不 会 令 你 感到 卫生。 不 过 ， 你 可 能 不 认得 的 是 
前 组 (prefix) 为 "stripes" 的 几 个 标签 。Stripes 标 签 库 可 以 作为 JSTL 的 补 
充 ， 辅 助 你 的 应 用 程序 类 和 视图 协同 工作 。 例 14-12 演 示 了 一 个 用 于 编 
辑 曲目 专辑 的 页 面 源 代码 。 


例 14-12: 曲目 编辑 视图 : webapp/albums/edit.jsp 


<%@page contentType="text/html; charset=UTF-8"language="java"%> 

<%@taglib prefix="c"uri="http://java.sun.com/jsp/jstl/core"%> 

<%@taglib 
prefix="stripes"uri="http://stripes.sourceforge.net/stripes.tld"%>@ 

<stripes: useActionBean 

beanclass="com.oreilly.hh.web.AlbumActionBean" 

var="actionBean"event="edit"/>@ 

<hi>Album Edit Page</hi> 

<stripes: form action="/Album.action">® 

<stripes: errors/> 

<stripes: hidden name="album.id"></stripes: hidden>@ 

<table> 

<tr> 

<td>Title: </td> 

<td><stripes: text name="album.title"/></td>® 

</tr> 

<tr> 

<td>Discs: </td> 

<td><stripes: text name="album.numDiscs"/> </td> 

</tr> 

</table> 

<h2>Album Comments </h2> 

<c: choose> 

<c: when test="${actionBean.album.id! =null}"> 


<stripes: link href="/albums/edit_comment.jsp"> 

<stripes: param name="album.id"value="${actionBean.album.id}"/> 
Add A Comment 

</stripes: link> 

<c: if test="${empty actionBean.album.comments}" > 

There are no album comments yet. 

</c: if> 

</c: when> 

<c: otherwise> 

Please add the album before entering comments. 

</c: otherwise> 

</c: choose> 

<ul> 

<c: forEach items="${actionBean.album.comments}"var="comment" > 
<1i>${comment}</1i> 

</c: forEach> 

</ul> 

<br/> 

<stripes: submit name="Save"value="Save"></stripes: submit>©@ 
</stripes: form> 


可 以 看 到 是 一 个 外 观 界面 相当 普通 的 JSP 页 面 ， 不 过 ， 也 有 一 
些 东西 值得 更 仔细 地 研究 一 


@taglib 声 明 用 于 引入 Stripes 标 签 库 ， 以 便 页 面 上 的 代码 可 以 通 
过 "stripes: "前 级 来 使 用 它们 。 


@ 这 里 使 用 useActionBean 标 签 来 告诉 Stripes 初 始 化 
AlbumActionBean， 如 果 它 的 edit 事 件 没 有 发 生 的 话 (例如 ， 浏 览 器 直 
接 请 求 JSP 页 面 ， 而 不 是 通过 action URL) ， 就 运行 这 个 事件 。edit 事 件 
将 会 从 数据 库 中 加 载 Album 对 象 ， 为 生成 表单 做 好 准备 。 


昌 Stripes 的 form 标 等 会 输出 一 个 普通 的 HTIML 表 单 ， 以 及 很 多 隐藏 
在 幕后 的 东西 。 它 的 action 属 性 指定 表单 将 要 提交 到 的 ActionBean 。 


@Stripes 的 hidden 标 签 的 作用 类 似 于 普通 HTML 的 input 标 签 。 使 用 
Stripes 版 本 的 标签 的 好 处 是 :， 它 的 值 是 目 动 生成 的 。 


@Stripes 的 text 标 签 可 以 创建 一 个 文本 输入 字段 (这 和 你 想到 的 应 
该 一 致 ) 。hidden 标 签 ， 它 可 以 自动 生成 其 value 属 性 的 值 。 


@Stripes 的 submit 标 签 会 生成 一 个 典型 的 提交 按钮 。 这 里 要 注意 的 

Æ: submit 标 签 的 name 属 性 值 是 当 表单 提交 时 要 调用 的 ActionBean 事 件 
处 理 方法 的 名 称 。 在 这 个 例子 中 ， 调 用 的 是 AlbumActionBean.save () 
(本 章 后 面 在 讨论 ActionBean 时 将 进一步 解释 事件 和 它们 的 处 理 颖 ) 。 


Stripes 也 有 一 个 label 标 签 ， 可 以 帮助 设置 本 地 化 (localization) Bc 
置 ， 让 代码 保持 傈 话 。 我 们 在 这 没有 使 用 它 ， 是 因为 想 只 关注 
Hibernate 的 东西 。 邓 好 Stripes 也 为 这 些 标签 提供 了 很 详细 的 文档 A 
) 


这 个 页 面 写 好 以 后 ， 接 下 来 还 要 编写 一 个 用 于 列 出 数据 库 中 的 专 
辑 的 页 面 ， 可 以 将 这 个 页 面 作为 一 个 加 载 页 面 ， 通 过 它 能 够 看 到 数据 
BHAT Ate ° iia 
点 ， 不 过 ， 要 注意 一 下 结尾 处 的 Stripes link 标 签 。 


例 14-13: 专辑 列表 视图 : webapp/albums/list.jsp 


<%@page contentType="text/html; charset=UTF-8"language="java"%> 
<%@taglib prefix="c"uri="http://java.sun.com/jsp/jstl/core"%> 
<%@taglib prefix="Stripes" 


uri="http://stripes.sourceforge.net/stripes.tld"%> 

<stripes: useActionBean 
beanclass="com.oreilly.hh.web.AlbumActionBean" 

var="actionBean"event="list"/> 

<table> 

<tr> 

<th>title</th> 

<th>discs</th> 

<th>action</th> 

</tr> 

<c: forEach items="${actionBean.albums}"var="album"> 

<tr> 

<td>${album.title}</td> 

<td>${album.numDiscs}</td> 

<td><stripes: link href="/albums/edit.jsp"> 

<stripes: param name="album.id"value="${album.id}"/> 

edit 

</stripes: link> </td> 

</tr> 

</c: forEach> 

</table> 

<stripes: link href="/albums/edit.jsp">new</stripes: link> 


stripes: link 标 签 用 于 将 程序 和 HTML 销 点 (anchor) 链接 起 来 ， 它 
提供 了 几 个 属性 ， 可 以 构建 指向 ActionBean 事 件 处 理 器 以 及 JSP 的 
URL ° 


编写 ActionBean 


接 下 来 应 该 编写 一 个 ActionBean。 可 以 将 ActionBean 看 做 是 MVC 
(Model ` View ` Controller) 模式 中 的 控制 器 组 件 。 例 14-14 演 示 了 我 
们 的 第 一 个 AlbumActionBean， 它 可 以 让 你 很 好 地 了 解 编写 ActionBean 
需要 涉及 哪些 内 容 。 


这 个 类 中 的 方法 可 以 分 为 两 大 类 : 属性 存 取 左 和 事件 处 理 器 。 属 

性 存 取 器 就 像 其 他 Java Bean 的 setter 和 getter 方 法 一 样 ， 所 以 它们 看 起 来 
也 差不多 。 另 一 方面 ， 那 些 返 回 Resolution 的 方法 就 显得 有 些 陌 生 了 ， 
不 过 其 概念 也 相当 简单 。 当 一 个 请 求 到 达 StripesDispatcher 时 ，HTTP 请 
求 中 的 某 个 部 分 就 可 以 指示 出 一 个 事件 的 名 称 ， 由 该 事件 的 处 理 器 负 
责 处 理 这 个 HTTP 请 求 。 当 Stripes 请 求 的 生命 周期 经 过 它 的 
BindingAndValidation 阶 段 后 ， 吏 会 调用 由 请 求 确 定 的 事件 处 理 需 方法 

(StripesDispatcher 使 用 反射 来 查找 其 名 称 和 事件 匹配 的 方法 ， 该 方法 
返回 的 就 是 一 个 Resolution) 。 由 事件 处 理 器 返回 的 Resolution 对 象 接着 
再 由 StripesDispatcher 进 行 处 理 (通常 进行 转发 或 重 定 向 ) 。 例 14-14 演 
示 了 我 们 的 AlbumActionBean.java ° 


例 14-14: 专辑 控制 颖 : AlbumActionBean.java 


package com.oreilly.hh.web; 

import java.util.List; 

import org.apache.1log4j.Logger; 

import net.sourceforge.stripes.action.’*; 

import net.sourceforge.stripes.integration.spring.SpringBean; 
import net.sourceforge.stripes.validation.*; 

import com.oreilly.hh.dao.AlbumDAO; 

import com.oreilly.hh.data.Album; 

JEF 

*Class that implements the web based front end of our Jukebox. 
* 

*/ 

public class AlbumActionBean implements ActionBean{ 

[** 

*Logger 

*/ 


private static Logger log=Logger .getLogger 
(AlbumActionBean.class) 


SER 

*The ActionBeanContext provided to this class by Stripes 
DispatcherServlet. 

£ 

private ActionBeanContext context; 

JEF 

*The list of Album objects we will display on the Album list 
page. 

oy. 

private List<Album>albums; 

SER 

*The Album we are providing a form for on the edit page. 

*/ 

private Album album; 

JER 

*The Data Access Object for our Albums. 

$7 

private AlbumDAO albumDAO; 

public ActionBeanContext getContext () {0 

return context; 


public void setContext (ActionBeanContext aContext) { 
context=aContext; 

} 

A 

*The default event handler that displays a list of Albums. 
*@return a forward to the Album list jsp. 

Py. 

@DefaultHandler 

public Resolution list () {@ 

albums=albumDAO. list () ; © 

return new ForwardResolution ("/albums/list.jsp") ; 

} 

AER 

*The event handler for handling edits to an Album 
*@return a forward to the Album edit jsp. 

*/ 

public Resolution edit () { 

if (album! =null) {@ 

album=albumDAO.get (album.getId () ) ; 

} 


return new ForwardResolution ("/albums/edit.jsp") ; 
} 

JER 

*The event handler for saving an Album. 

*@return a redirect to the Album list jsp. 

*/ 

public Resolution save () { 


albumDAO.persist (album) ; 

log.debug ("Redirecting to list! ") ; 

return new RedirectResolution ("/albums/list.jsp") ; 

} 

JEX 

*A getter for the view to retrieve the list of Albums. 

*@return a list of Albums 

A 

public List<Album>getAlbums () {© 

return albums; 

} 

JAR 

*A setter for the DispatcherServlet to call that provides the 
album to 

*save. 

*/@param anAlbum 

@ValidateNestedProperties ({@ 

@Validate (field="title", required=true, on={"save"}) , 

@Validate (field="numDiscs", required=true, on={"save"}) 

}) 

public void setAlbum (Album anAlbum) { 

log.debug ("setAlbum") ; 

album=anAlbum; 

} 

JER 

*A getter for the edit view to call. 

*@return an Album 

is 

public Album getAlbum () { 

return album; 

} 

JEK 

*A method Spring will call that provides this class with an 
AlbumDAO 

*instance.@param anAlbumDAO The AlbumDAO object 

*/ 

@SpringBean ("albumDAO") @ 

public void injectAlbumDAO (AlbumDAO albumDAO) { 

this .albumDAO=albumDAO; 

} 

} 


@ActionBean 接 口 惟一 要 求 必须 实现 的 是 setContext () 和 
getContext () 方法 ，ActionBean 可 以 通过 这 两 个 方法 来 获取 有 关 它 的 


操作 所 在 的 Stripes 环 境 的 信息 。 


四 这 个 返回 Resolution 的 public 的 方法 在 Stripes 中 称 为 事件 处 理 希 。 
它们 被 目 动 绑 定 到 浏览 锅 能 够 访问 的 URL 上 。 例 如 ， 对 于 访问 路 


径 /stripesapp/Album.action?save=，Dispatcher 就 会 选中 这 个 方法 。 


日 现在 还 没有 AlbumDaoJlist () 方法 ， 所 以 我 们 需要 将 它 增 加 到 
AlbumDAO 接 口 (其 定义 位 于 第 13 章 ) 和 AlbumHibernateDAO 实 现 类 
中 o 


@“ 如 采 专 辑 不 为 null， 那 么 就 加 载 专 辑 ” 似 乎 有 点 逆向 逻辑 的 意 
味 ， 但 是 真正 发 生 的 情况 是 : 当 Stripes 将 请 求 绑 定 到 ActionBean 中 的 对 
象 时 ， 它 看 到 的 只 是 一 个 album.id 参 数 ， 用 这 个 id 值 来 创建 一 个 新 的 
Album 对 象 ， 接 着 再 调用 这 个 方法 。 但 是 我 们 真正 想 知 道 的 是 如 何 从 数 
据 库 中 加 载 一 个 Album 对 象 ， 再 编辑 它 ， 所 以 这 台 是 我 们 在 这 里 所 做 的 
处 理 。 


@ 当 在 请 求 中 发 现 表 单数 据 与 bean 属 性 的 命名 模型 匹配 时 ，Stripes 
就 会 调用 ActionBean 中 相应 的 public 类 型 的 getter 和 setter 方 法 。 例 如 ， 当 
请 求 参数 中 有 album.id、album.title 以 及 album.numDiscsH 肝 ，Stripes 束 会 
调用 setAlbum () 方法 。 另 一 方面 ， 当 向 浏览 器 生成 表单 时 ， 就 会 使 
用 getter 方 法 预 生成 各 个 值 《这 也 就 是 例 14-12 中 的 那些 stripes: text 之 类 
的 标签 所 完成 的 作用 ) 


@Stripes 提 供 了 验证 标注 ， 用 于 标明 当 调 用 事件 处 理 右 时 应 该 看 到 
哪些 字段 。 我 们 在 此 处 不 准备 深入 介绍 更 详细 的 内 容 ， 你 可 以 在 Stripes 
的 在 线 文档 (B) 中 找到 更 多 的 信息 。 


@SpringBean 标 注 是 告诉 Stripes: 在 Spring 上 下 文中 查找 这 个 对 和 象 
值 ， 并 插入 到 这 里 。 我 们 在 这 里 没有 使 用 Spring 应 用 程序 中 典型 的 
public 类 型 的 setter 方 法 ， 因 为 黑客 (hacker) 可 能 会 调用 这 样 的 方法 来 
正确 地 格式 化 Web 请 求 ， 出 于 安全 原因 ， 我 们 应 该 防止 类 似 的 访问 。 为 
Spring 要 调用 《出 ) 的 方法 采用 其 他 命名 规范 ， 通 常 是 个 好 主意 。 


如 前 所 述 ，AlbumDAO 需 要 有 一 个 list () 方法 返回 所 有 的 Album 
对 象 ， 以 及 一 个 get O 方法 根据 专辑 的 id 来 取 回 对 应 的 Album 对 象 。 为 
此 ， 我 们 需要 调整 一 人 AlbumDAO 接 口 和 AlbumHibernateDAO 实 现 。 例 
14-15 演 示 了 更 新 后 的 AlbumDAO.java， 修 改过 的 部 分 以 粗 体 突出 显 


AN © 


(714-15: 在 AlbumDAO 中 增加 list () 和 get O 方法 的 定义 


package com.oreilly.hh.dao; 

import java.util.List; 

import com.oreilly.hh.data.Album; 
public interface AlbumDAO{ 

public Album persist (Album album) ; 
public void delete (Album album) ; 
public List<Album>list () ; 

public Album get (Integer id) ; 

} 


例 14-16 以 粗 体 突出 显示 了 需要 对 AlbumHibernateDAO.java 进 行 的 
修改 。 


例 14-16: 在 AlbumHibernateDAO 中 增加 list () 和 get O 方法 的 实 
现 


package com.oreilly.hh.dao.hibernate; 

import java.util.List; 

import 
org.springframework.orm.hibernate3.support.HibernateDaoSupport; 

import com.oreilly.hh.dao.AlbumDA0O; 

import com.oreilly.hh.data.Album; 

public class AlbumHibernateDAO extends HibernateDaoSupport 
implements AlbumDAO{ 

public Album persist (Album album) { 

album= (Album) getHibernateTemplate () .merge (album) ; 

getSession () .flush () ; 

return album; 


} 

public void delete (Album album) { 
getHibernateTemplate () .delete (album) ; 
} 


@SuppressWarnings ("unchecked") 
public List<Album>list () { 
return getHibernateTemplate () .loadAll (Album.class) ; 


} 
public Album get (Integer id) { 


return (Album) getHibernateTemplate () .load (Album.class, id) ; 
} 


} 
例 14-16 中 使 用 的 是 HibemateTemplate.loadAll () 方法 ， 它 与 
Session.loadAll () 的 功能 一 样 ， 将 返回 作为 参数 提供 的 类 的 所 有 持久 
化 对 象 的 列表 。 第 13 章 已 经 讨论 过 使 用 HibernateTemplate 类 的 优点 。 


现在 我 们 已 经 有 了 两 个 视图 ， 一 个 ActionBean， 也 对 DAO 进 行 了 
相应 的 修改 。 接 下 来 就 可 以 编译 和 体验 这 个 Web 应 用 程序 了 。 相 关 命 令 
如 例 14-17 所 示 。 


例 14-17: 编译 我 们 的 Stripes 应 用 程序 


$ant compile 

Buildfile: build.xml 

Overriding previous definition of reference to project.class.path 

prepare: 

compile: 

[javac]Compiling 20 source files to 

/home/rfowler/Hibernate Book/examples/chi2/webapp/WEB-INF/classes 

[copy]Copying 1 file to/home/rfowler/Hibernate 
Book/examples/ch12/webapp/ 

WEB - INF 

BUILD SUCCESSFUL 

Total time: 2 seconds 


当 部 署 例 14-5 所 示 的 应 用 程序 时 ， 我 们 将 Context 元 素 的 一 个 属性 
设置 为 : reloadable=true。 这 样 设置 以 后 ， 当 为 Web 应 用 程序 的 WEB- 
INF/classes 目 录 提 供 了 新 版 本 的 类 有 时，Tomcat 将 会 自动 重新 加 载 程序 的 
context。 假 设 你 让 Tomcat 仍 然 保 持 运 行 ， 如 果 稍 等 厂 刻 ，context 束 会 目 
动 加 载 完成 。 在 这 一 处 理 完 成 以 后 ， 就 可 以 用 浏览 器 来 访问 
http://localhost: 8080/stripesapp/albums/list.jsp， 看 到 的 页 面 应 该 如 图 14- 
SS 


at 
+ 
‘ty 


title discs action 


图 14-3 我 们 的 ActionBean 跑 起 来 了 


现在 我 们 的 数据 库 中 还 没有 数据 ， 所 以 这 个 页 面 也 不 会 显示 任何 
专辑 信息 。 但 是 点 击 "New" 链 接 ， 将 会 打开 例 14-12 编 写 的 编辑 页 面 ， 
如 图 14-4 所 示 。 


Mozilla Hirefox 


Ahom Edit Page 
Title: [| = —i‘S™S 


Discs: | 
Album Comments 


Please add the album before entering 
comments. 


Save | 


| Done | B © Adblock 
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图 14-4 加载 Edit (编辑 ) 页 面 


可 以 想象 到 这 个 页 面 的 功能 ， 在 表单 中 输入 有 效 的 数据 ， 点 
击 "Save" 提 交 表 单 后 ， 将 会 把 数据 保存 到 数据 库 中 ， 再 返回 到 列表 视 
图 ， 如 图 14-5 所 示 。 如 采 能 够 按 这 个 流程 走 下 来 的 话 ， 束 表明 你 已 经 成 


功 地 集成 了 Hibernate、Stripes 以 及 Spring! 花 些 时 间 来 思考 一 下 本 章 进 
行 的 数据 库 处 理 。 令 人 激动 的 应 该 是 没有 花费 多 少 代码 就 完成 了 这 么 
多 处 理 。 你 在 AlbumDAO 和 AlbumHibernateDAO 中 添加 了 list () 和 edit 
O 两 个 方法 ， 使 用 AlbumDAO 对 象 来 加 载 和 持久 化 Album 对 象 。 你 也 
会 注意 到 ， 整 个 过 程 中 没有 用 任何 代码 来 直接 处 理 
HTTPServletResponse 或 HITPServletRequest 对 象 一 Stripes 已 经 为 你 处 理 
好 了 这 些 楷 珊 的 工作 。 


lrA E R 


File Edit View History Bookmarks Tools Help $ 
口 http://localhost:8080/stripesapp/albums/lisi ~ 


title discs action 
Are you Experienced 1 edit 
new 


图 14-5 显示 了 一 些 内 容 的 列表 视图 


刚才 发 生 了 什么 


到 目前 为 止 ， 我 们 已 经 用 Stripes、Spring 以 及 Hibernate 构 建 好 了 一 
个 简单 的 Web 应 用 程序 。 现 在 我 们 可 以 列 出 所 有 的 专辑 、 创 建新 的 专 
辑 、 对 专辑 进行 编辑 。AlbumActionBean 使 用 Stripes 和 第 13 章 写 的 
Hibernate DAO 来 保存 对 象 ， 为 视图 提供 对 象 。 


BO BMT A 


既然 我 们 已 经 讨论 了 如 何 实现 基本 的 插入 、 更 新 、 显 示 数 据 的 处 
理 ， 我 们 束 回 过 头 来 ， 看 看 怎么 在 程序 中 人 处理 关联 。 现 在 我 们 还 根本 
没有 认真 思考 过 它 。 


[1] http://www.stripesframework.org/display/stripes/Download. 
[2] http://www.stripesframework.org/display/stripes/Documentation. 
[3] http://www.stripesframework.org/display/stripes/Validation+Reference. 


[4] http://www.stripesframework.org/display/stripes/Spring+with+ Stripes. 


处 理 天 联 


因为 我 们 的 例子 还 没有 处 理 任何 关联 ， 所 以 就 避 开 了 典型 应 用 程 
序 中 会 遇 到 的 一 个 复杂 问题 。 其 实 ， 当 DAO 对 象 在 它们 的 persist () 
方法 中 调用 merge () 方法 时 ， 就 会 持久 化 你 发 送 给 它 的 任何 东西 。 如 
果 正 在 持久 化 的 对 象 没 有 包含 所 有 与 它 关 联 的 对 象 ， 那 么 就 会 改写 原 
来 持久 化 的 数据 ， 而 那些 没有 包含 的 关联 也 会 随 之 丢失 。 例 如 ， 如 果 
一 个 专辑 Album 原 本 有 两 个 评论 ， 但 是 保存 时 使 用 的 是 一 个 空 的 评论 
集合 ， 那 么 以 前 数据 库 中 原 有 的 评论 就 会 丢失 。 我 们 在 这 一 节 就 为 添 
加 和 编辑 专辑 的 评论 而 实现 一 个 事件 处 理 器 和 视图 。 只 有 这 样 ， 你 才 
能 明白 我 们 正在 解决 的 问题 到 底 是 怎么 回 事 儿 ， 我 们 再 去 讨论 如 何 解 
决 这 个 问题 。 首 先 ， 增 加 一 个 editComments.jsp 文 件 ， 其 内 容 如 例 14- 
18 所 示 ， 它 为 添加 专辑 评论 提供 相应 的 表单 。 


例 14-18: 评论 编辑 器 : webapp/albums/edit_comment.jsp 


<%Q@page contentType="text/html; charset=UTF-8"language="java"%> 

<%@taglib prefix="c"uri="http://java.sun.com/jsp/jstl/core"%> 

<%@taglib 
prefix="stripes"uri="http://stripes.sourceforge.net/stripes.tld"%> 

<stripes: useActionBean 
beanclass="com.oreilly.hh.web.AlbumActionBean"var= 

"actionBean"event="edit"/ > 

<hi>Add a comment for the album<span style="font-style: 
italic" >${action 

Bean.album.title}</span></h1> 

<stripes: form action="/Album.action" > 

<stripes: hidden name="album.id"/> 


Comment: <stripes: text name="comment"/> 

<br/> 

<stripes: submit name="saveComment"value="Save"/> 
</stripes: form> 


这 个 JSP 文 件 看 起 来 有 点 熟 悉 ， 因 为 它 沿 用 了 与 例 14-12 同 样 的 模 
式 。 你 可 以 告诉 stripes: form 标 签 ， 这 个 页 面 要 提交 到 我 们 已 经 创建 
的 AlbumActionBean。 由 于 stripes: submit 标 签 的 name 属 性 为 
saveComment， 所 以 我 们 需要 在 AlbumActionBean 中 增加 一 个 public 类 
型 的 saveComment O 方法 ， 它 同样 也 返回 一 个 Resolution。 因 为 
stripes: text 标 签 的 name 属 性 为 comment， 我 们 也 需要 在 bean 中 创建 
setComment () 和 getComment () 属性 存 取 器 。 例 14-19 演 示 了 
AlbumActionBean.java 中 新 增加 的 这 些 内 容 。 


例 14-19: AlbumActionBean.java 中 为 了 支持 评论 而 新 增加 的 内 容 


fre 

*Event handler to save a comment to the Album 

*@return redirect to the edit Album page. 

*/ 

public Resolution saveComment () { 

Album a=albumDAO.get (album.getId () ) ; 

a.getComments () .add (comment) ; 

albumDAO.persist (a) ; 

RedirectResolution r=new RedirectResolution 
("/albums/edit.jsp") ; 

r.addParameter ("album.id", album.getId () ) ; 

return r; 

} 

JER 

*@return the comment 

*/ 

public String getComment () { 

return comment; 


} 

SAER 

*@param aComment the comment to set 
k 


public void setComment (String aComment) { 
comment=aComment; 


当 重 新 编译 ， 并 使 用 儿 下 新 功能 以 后 ， 你 可 能 会 发 现 程 序 有 个 非 
常 严 重 的 bug。 如 果 先 为 某 个 Album 增 加 些 评 论 ， 接 着 再 更 新 同一 
Album 的 标题 或 唱片 数量 时 ， 你 会 发 现 评论 不 见 了 。 产 生 这 个 bug 的 原 
因 是 每 次 调用 saveAlbum () 方法 时 ，Stripes 就 会 创建 一 个 新 的 Album 
对 象 ， 我 们 接着 再 告诉 Hibernate 保 存 这 个 新 对 象 。 这 个 新 对 象 还 没有 
评论 ， 但 它 确实 有 个 ID， 所 以 Hibernate 会 更 新 持久 化 的 Album， 让 和 它 


没有 评论 。 


保存 具有 关联 的 对 象 ， 可 以 用 两 种 方法 。 一 种 是 将 inverse 标 志 设 
置 为 nue， 这 样 当 更 新 对 象 时 ， 对 关联 所 做 的 任何 修改 都 将 被 忽略 。 
不 过 ， 这 种 方法 对 专辑 评论 没有 效 末 ， 因 为 评论 只 是 我 们 的 模型 中 的 
字符 串 ， 并 不 是 完整 的 实体 ， 所 以 在 评论 对 象 上 没有 setAlbum () 之 
类 的 方法 可 以 调用 。 另 一 种 解决 这 个 问题 的 方法 是 在 Stripes 调 用 bean 
上 的 任何 setter 存 取 需 方法 之 前 ， 束 真正 从 数据 库 中 加 载 这 个 对 象 以 及 
它 所 关联 的 所 有 对 象 。 这 样 ， 在 Stripes 开 始 修改 这 个 对 象 以 前 ， 关 联 
的 对 象 已 经 生成 好 了 。 这 种 方法 听 起 来 很 不 错 ， 我 们 试 一 试 。 


也 应 该 思考 一 下 Stripes 处 理 请 求 的 生命 周期 。Stripes Lifecycle 
Documentation (H!) 详细 解释 了 各 个 阶段 发 生 的 事情 ， 如 果 你 渴望 研 
完 额外 的 信息 ， 参 考 这 些 文档 束 可 以 。 人 简单 来 说 ， 在 解析 好 事件 处 理 
器 以 后 ， 有 一 个 称 为 BindingAndValidation 的 阶段 ， 用 于 调用 
ActionBean 上 的 各 setter 方 法 。Stripes 提 供 了 一 种 “拦截 
az” (interceptor) 机 制 ， 通 过 这 种 机 制 ， 我 们 可 以 在 
BindingAndValidation 运 行 以 前 插入 我 们 目 己 的 处 理 代码 。 


拦截 器: 扩 展 Stripes 的 mR 


为 了 告诉 我 们 的 拦截 絮 在 什么 时 候 运 行 ， 可 以 在 我 们 的 
ActionBean 中 创建 自己 的 标注 。 这 样 ， 我 们 的 扩展 束 很 自然 地 集成 到 
Stripes 的 其 他 工作 方式 中 。 


一 些 人 不 赞成 使 用 拦截 器 和 面向 切面 的 编程 (Aspect Oriented 
Programming, AOP) ， 因 为 调试 AOP 软 件 一 般 都 很 困难 。 在 一 些 AOP 
应 用 程序 中 ， 很 难 确定 正在 运行 什么 代码 和 代码 运行 的 时 间 。 不 过 ， 
随 着 一 些 新 功能 的 出 现 ， 如 Java 5 标注 ， 用 自 文档 化 (self- 
documenting) 的 方法 就 可 能 做 更 多 的 事情 (而 不 用 依赖 非 语 言 的 容 
门 ) ， 所 以 我 鼓励 你 对 Stripes 的 拦截 器 实现 保持 开放 的 思想 。 事 实 
上 ，Stripes 和 Spring 都 非常 有 效 地 利用 了 这 种 方法 。Stripes 使 用 的 拦截 
器 模式 会 检查 ActionBean 中 的 某 些 标注 ， 并 基于 那些 标注 而 采取 一 定 


的 行动 。 采 用 这 种 方法 ，Stripes 也 可 以 文 持 基于 Spring 的 依赖 注入 ， 还 
可 以 在 适当 的 生命 周期 阶段 调用 特定 的 ActionBean 方 法 。 按 照 这 种 模 
式 来 增加 我 们 目 己 的 功能 也 相当 人 簿 单 ， 所 以 我 们 打算 在 绑 定 和 验证 阶 
段 之 前 增加 一 种 用 于 加 载 数据 bean 的 机 制 。 


如 果 你 以 前 还 没有 写 过 标注 ， 对 它 的 语法 可 能 会 觉得 有 些 陌 生 ， 
但 思想 是 相当 直观 的 。 例 14-20 中 的 代码 是 说 ， 开 发 人 员 将 能 够 用 
@LoadBean 标 注 来 标记 方法 ， 提 供 在 Binding-AndValidation 发 生 之 前 需 
要 加 载 的 成 员 的 名 称 (标注 本 身 并 不 提供 这 些 语义 ， 它 只 是 支持 这 种 
语法 。 我 们 在 例 14-22 中 演示 的 Interceptor 代 码 就 使 用 该 标注 来 实现 想 
要 的 功能 ) 。 例 14-20 演 示 了 我 们 的 新 标注 ， 应 该 将 它 保存 为 


LoadBean.java ° 


例 14-20: 创建 LoadBean 标 注 


package com.oreilly.hh.web; 

import java.lang.annotation.”*; 

JER 

*An annotation used to mark methods with a bean to load. 
*@author Ryan Fowler 

*/ 

@Retention (RetentionPolicy.RUNTIME) @ 
@Target ({ElementType.METHOD}) @ 
@Documented® 

public@interface LoadBean{® 

JES 

*The name of the bean to load. 

*/ 

String value () ; © 


@ 这 个 标注 中 的 @RetentionPolicy 取 值 为 RunTime， 这 是 在 告诉 
Java， 在 编译 生成 的 类 中 保存 标注 信息 ， 以 便 我 们 的 拦截 器 
(Interceptor) 在 运行 时 能 够 看 到 它们 。 对 ， 在 编写 标注 类 时 也 可 以 使 
用 很 多 其 他 标注 。 


@@Target 标 注 用 于 指定 LoadBean 标 注 应 该 应 用 到 什么 类 型 的 元 
素 。 当 运行 特定 的 ActionBean 事 件 处 理 右 时 ， 我 们 的 拦截 絮 束 会 检查 
标注 。 由 于 事件 处 理 器 是 ActionBean 中 的 方法 ， 所 以 这 里 的 目标 类 型 
设置 为 ElementType.METHOD ° 


上 日 @Documented 标 注 指定 应 该 用 JavaDoc 来 文档 化 LoadBean 标 注 。 


@ 面 对 @interface 这 样 的 说 明 符 ， 标 注定 义 语法 让 人 乍 看 起 来 感觉 
很 不 安 。 在 Java 中 增加 新 的 功能 的 愿望 与 日 俱 增 ， 但 是 却 没有 增加 新 
的 关键 子 ， 这 样 就 导致 了 在 定义 标注 时 还 得 重用 interface 关 键 子 。 要 十 
这 两 种 需求 能 够 从 技术 上 得 以 很 好 地 解决 ， 标 注定 义 的 可 读 性 也 殉 不 
会 受到 什么 影响 了 。 


Ovalue () 方法 的 定义 只 是 规定 这 个 标注 只 有 一 个 参数 ， 该 参数 
的 名 称 是 value。 之 所 以 要 使 用 value 作 为 参数 名 称 ， 原 因 是 这 样 可 以 使 
用 简写 形式 的 @LoadBean ("memberName") ， 而 不 必 使 用 稍微 长 些 的 
@LoadBean (value="memberName") 。 这 是 标注 机 制 本 身 文 持 的 一 种 


规范 。 


现在 ， 我 们 可 以 在 AlbumActionBean 中 相关 的 事件 处 理 器 上 应 用 
这 个 标注 ， 以 告诉 拦截 絮 它 需要 做 什么 。@LoadBean 标 注 稍 后 会 告诉 
我 们 的 拦截 器 在 Stripes 调 用 Album 上 的 setter 方 法 之 前 加 载 Album 


bean ° 


例 14-21: 新 的 AlbumActionBean.save () 事件 处 理 器 


JEX 

*The event handler for saving an Album. 

*@return a redirect to the Album list jsp. 

*/ 

@LoadBean ("album") 

public Resolution save () { 

albumDAO.persist (album) ; 

log.debug ("Redirecting to list! ") ; 

return new RedirectResolution ("/albums/list.jsp") ; 


OK， 这 一 切 听 起 来 都 相当 不 错 ， 但 是 神奇 的 拦截 器 的 工作 原理 是 
怎么 样 的 ? 为 了 加 载 那个 Album bean， 我 们 需要 某 个 东西 ， 它 应 该 在 
BindingAndValidation 阶 段 之 前 运行 ， 这 样 才 能 加 载 数 据 。 前 面 我 们 提 
到 ，Stripes 提 供 了 一 种 拦截 器 执行 功能 ， 这 正 是 我 们 需要 的 钧 子 
(hook) 。 为 了 使 用 这 个 功能 ， 我 们 得 编写 一 个 实现 Stripes Interceptor 
接口 的 类 ， 再 用 StripesFilter 的 init-param 告 诉 Stripes 要 使 用 这 个 拦截 
器 。 在 这 个 拦截 器 类 中 用 @Intercepts 标 注 可 以 告诉 Stripes 它 对 什么 生 
命 周 期 阶段 感 兴趣 ， 在 那些 执行 点 上 就 会 调用 实现 的 intercept O 方 
法 。 


在 我 们 的 intercept O 方法 中 ， 会 在 事件 处 理 器 中 检查 @LoadBean 
标注 。 如 果 那 个 标注 存在 ， 就 用 Spring 和 Hibernate 尝 试 加 载 那 个 标注 
的 value 属 性 指定 的 名 称 所 对 应 的 对 象 。 这 一 步 完 成 以 后 ， 通 过 调用 
ExecutionContext.proceed () 和 它 的 返回 值 ， 拦 截 器 就 会 指示 Spring 接 
下 来 继续 要 做 什么 事情 。 例 14-22 演 示 了 LoadObjectInterceptorjava 的 源 
代码 。 


例 14-22: 对 象 加 载 拦 截 器 


package com.oreilly.hh.web; 
import java.lang.reflect.Method; 
import javax.servlet.http.HttpServletRequest; 
import org.apache.1log4j.Logger; 
import org.springframework.orm.hibernate3.HibernateTemplate; 
import net.sourceforge.stripes.action.Resolution; 
import net.sourceforge.stripes.controller.*; 
import net.sourceforge.stripes.integration.spring.*; 
import net.sourceforge.stripes.util.bean.BeanUtil; 
@Intercepts ({LifecycleStage.BindingAndValidation}) @ 
public class LoadObjectInterceptor extends 
SpringInterceptorSupport 
implements Interceptor{ 
HibernateTemplate hibernateTemplate; 
private Logger log=Logger.getLogger 
(LoadObjectInterceptor.class) ; 
public Resolution intercept (ExecutionContext ctx) throws 
Exception{@® 
Method handler=ctx.getHandler () ; 
LoadBean loadProperty=handler.getAnnotation (LoadBean.class) ; © 
if (loadProperty! =null&&loadProperty.value () ! ="" 
& &loadProperty.value () ! =null) {0 
String propertyName=loadProperty.value () ; 
String idName=propertyName+".id"; 
HttpServletRequest request=ctx.getActionBeanContext 
() .getRequest () ; © 
String idValue=request.getParameter (idName) ; 
Class<?>propertyClass= 


BeanUtil.getPropertyType (propertyName, ctx.getActionBean () ) ; 
if (idValue! =null&&idvalue! ="") { 

Object o=hibernateTemplate.get (propertyClass, 

Integer.valueOf (idValue) ) ; @ 

BeanUtil.setPropertyValue (propertyName, 

ctx.getActionBean () 

propertyClass.cast (0) ) ; © 

} 


Resolution resolution=ctx.proceed () ; © 
return resolution; 


} 

@SpringBean ("hibernateTemplate") @ 

public void injectHibernateTemplate (HibernateTemplate 
aHibernateTemplate) { 

this .hibernateTemplate=aHibernateTemplate; 

} 

} 


@Stripes 已 经 知道 这 个 类 要 成 为 一 个 Interceptor， 因 为 在 web.xml 中 
已 经 列 出 了 相关 的 配置 。 不 过 ， 它 的 @Intercepts 标 注 还 告诉 Stripes， 
这 个 特殊 的 拦截 屡 类 将 拦截 哪个 生命 周期 阶段 。 


@intercept () 方法 就 是 在 我 们 感 兴趣 的 生命 周期 阶段 将 要 调用 的 
方法 。 在 这 个 方法 中 ， 我 们 想 加 载 数据 。 需 要 做 的 第 一 件 事 是 找到 
Spring 已 经 选择 的 事件 处 理 屁 a hi 
注 。Spring 让 这 些 操作 变 得 很 简单 ， 通 过 ExecutionContext.get-Handler 

O 方法 就 可 以 返回 代表 事件 处 理 器 的 Method 对 象 。 


@Java 5 的 标注 机 制 可 以 很 好 地 对 反射 (reflection) 提供 扩展 支 
持 ， 我 们 只 要 简单 地 调用 Method.getAnnotation () ， 就 可 以 找到 事件 
处 理 器 方法 中 的 @LoadBean 标 注 〈 如 果 确 实 存在 ) ° 


@ 如 果 没 有 找到 请 求 类 型 的 标注 ，getAnnotation () 方法 就 返回 
null， 所 以 Interceptor 要 检查 是 否 找 到 了 @LoadBean 标 注 ， 以 及 它 的 值 
是 否 足 以 让 Hibernate 能 够 继续 加 载 数据 。LoadBean.value () 方法 返回 
原来 附加 到 事件 处 理 器 标注 上 的 参数 。 在 例 14-21 中 ， 将 propertyName 
的 取 值 设置 为 了 album 。 


没有 谈 及 的 一 个 命名 规范 是 ， 我 们 一 直 将 数据 bean 的 id 属性 命名 
为 d。 从 Stripes 构 建 请 求 参 数 的 方法 来 看 ， 这 意味 着 只 要 简单 地 将 字 
符 串 ".id" 附 加 到 通过 @LoadBean 标 注 找到 的 bean 名 称 的 后 面 ， 束 能 够 
构造 出 包含 想 要 加 载 的 bean 的 ID 属性 值 的 参数 。 在 例 14-21 中 ， 相 关 的 


请 求 参数 是 album.id 。 


@ 我 们 已 经 知道 了 想 要 加 载 的 请 求 参数 的 名 称 ， 这 样 就 能 够 在 请 
求 参 数 中 查找 这 个 参数 ， 这 是 通过 


ExecutionContext.getActionBeanContext () .getRequest () 来 完成 的 。 


@ 在 拦截 器 使 用 Spring 的 HibernateTemplate 加 载 数据 对 象 之 前 ， 还 
需要 知道 试图 加 载 的 对 象 是 什么 类 型 的 。Stripes 提 供 了 一 个 名 为 
BeanUtil 的 实用 工具 类 来 处 理 bean， 以 便 简化 这 种 与 bean 交 互 的 操作 。 
BeanUtil.getPropertyType () 返回 一 个 Class 对 象 ， 准 确 地 告诉 我 们 需 
要 知道 的 一 切 。 


@@ 装 备 好 了 我 们 想 要 加 载 对 象 的 ID 和 类 型 ， 就 可 以 让 Hibernate 完 
成 加 载 『。 只 需要 将 这 些 参数 传递 给 HibernateTemplate.get () 方法 ， 
即 可 加 载 我 们 想 要 的 数据 。 注 意 ， 这 个 Interceptor 完 全 是 通用 的 ， 它 不 
需要 特定 类 型 的 DAO， 能 够 在 任何 在 使 用 这 些 框架 的 应 用 程序 中 ， 处 
理 任何 绑 定 到 Hibernate 映 冉 对 象 上 的 数据 bean 。 


@BeanUtil 也 提供 了 一 个 setPropertyValue () 方法 ， 可 以 为 数据 对 
象 的 属性 进行 赋值 。 在 这 里 需要 将 从 Hibernate 返 回 的 数据 对 和 象 的 类 型 
转换 为 前 面 已 经 准备 好 的 类 型 ， 否 则 调用 ActionBean 上 的 setter 方 法 将 
BAe? 


OExecutionContext.proceed () 方法 返回 一 个 Resolution 实 例 ， 将 
Stripes 指 加 下 一 件 要 做 的 事 的 链接 。 


四 束 像 ActionBean 中 的 一 样 ， 从 SpringInterceptorSupport 继 承 的 类 
能 够 通过 Spring 的 依赖 注入 来 实例 化 。 在 这 个 例子 中 ， 我 们 从 Spring 中 
获取 HibernateTemplate 类 。 


现在 需要 让 Stripes 知 道 它 应 该 运行 刚才 创建 的 
LoadObjectInterceptor。 为 了 提供 Spring bean 注 入 ， 我 们 已 经 在 web.xml 
中 配置 好 了 SpringInterceptor。 将 LoadObjectInterceptor 放 在 
Interceptor.Classes init-param 的 SpringInterceptor 和 


BeforeAfterMethodInterceptor 条 目 之 间 ， 如 例 14-23 所 示 。 


例 14-23: 在 web.xml 中 将 我 们 的 Interceptor 添 加 到 StripesFilter 


<filter> 

<display-name>Stripes Filter</display-name> 
<filter-name>StripesFilter </filter-name> 
<filter-class> 
net.sourceforge.stripes.controller.StripesFilter 
</filter-class> 

<init-param> 

<param-name >ActionResolver .PackageFilters</param-name> 
<param-value>com.oreilly.*</param-value> 
</init-param> 

<init-param> 
<param-name>ActionResolver.UrlFilters</param-name> 
<param-value >WEB-INF/classes </param-value > 
</init-param> 

<init-param> 

<param-name> Interceptor .Classes </param-name > 
<param-value> 
net.sourceforge.stripes.integration.spring.SpringInterceptor, 
com.oreilly.hh.web.LoadObjectInterceptor, 
net.sourceforge.stripes.controller.BeforeAfterMethodInterceptor 
</param-value> 

</init -param> 

</filter> 


在 前 面 的 第 13 章 中 ，DAO 对 象 可 以 继承 HibernateDAOSupport， 但 
我 们 这 里 的 LoadObject-Interceptor 不 能 这 样 做 。 为 了 使 用 依赖 注入 ， € 
现在 需要 继承 Stripes 的 SpringInterceptorSupport。 为 此 ， 我 们 在 
LoadObjectInterceptor 中 添加 了 一 个 injectHibernateTemplate () 方法 ， 


还 要 在 applicationContext.xml 中 用 id hibernateTemplate 定 义 一 个 


HibernateTemplate bean， 如 例 14-24 所 示 。 


例 14-24: 在 applicationContext.xml 中 为 我 们 的 Interceptor 注 入 
HibernateTemplate 


<bean 
id="hibernateTemplate"class="org.springframework.orm.hibernates3. 

HibernateTemplate" > 

<property name="sessionFactory" > 

<ref bean="sessionFactory"/> 

</property> 

<property name="cacheQueries" > 

<value >true</value > 

</property> 

</bean> 


再 次 运行 ant compile, Tomcat 应 该 重新 加 载 context， 这 时 应 用 程序 

就 应 该 可 以 正确 处 理 前 面 我 们 无 法 解决 的 专辑 评论 的 问题 了 。 在 调用 
AlbumActionBean 的 save 事 件 处 理 絮 以 前 ， 会 完 调用 
LoadObjectInterceptor.intercept () 方法 。 因 为 在 AlbumActionBean.save 

() 方法 上 有 一 个 @LoadBean 标 注 ，LoadObjectInterceptor 就 会 党 试用 
请 求 参 数 album.id 所 代表 的 id 来 加 载 Album 对 象 。 如 果 这 种 方法 正常 运 
行 ， 当 Stripes 开 始 调用 Album 上 的 setter 方 法 时 ， 关 联 数据 应 该 就 已 经 
在 Album 中 了 。 所 以 ， 再 调用 persist O 方法 时 ， 关 联 数据 就 不 会 丢失 
Ta 


这 个 例子 让 人 感 兴趣 的 部 分 古 它 演示 了 如 何 扩 展 Stripes 的 功能 ， 
非常 傈 洁 的 一 所 有 功能 都 在 幕后 运行 ， 用 简单、 紧凑 的 标注 来 触 
{1e 


yo 


= 
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我 们 已 经 演示 了 一 种 集成 Hibernate 和 Stripes 的 方法 。Stripes 带 来 的 
实用 的 功能 、 先 进 的 编码 技术 、 适 度 的 扩展 点 ， 这 些 让 它 成 为 一 个 使 
用 起 来 令 人 感到 愉快 的 web 框 名 。 大 多 数 Web 应 用 程序 都 需要 某 种 持 
入 化 机 制 ，Hibernate 的 ORM 功 能 与 Stripes 的 目 动 对 象 生 成 机 制 的 组 合 
成 就 了 一 种 功能 更 为 强大 的 工具 。 编 写 项 目 不 再 只 是 追求 可 以 用 什么 
组 件 ， 而 是 讲究 怎么 让 集成 可 以 更 光滑 ， 怎 么 能 让 各 个 组 件 更 好 地 彼 
此 适应 (尤其 是 用 Spring 集 成 各 组 件 ) ° 


你 可 以 将 本 章 人 研究 的 一 些 技术 应 用 到 其 他 Java 项 目 。 使 用 拦截 右 
来 检查 正在 处 理 的 类 中 保存 的 元 数据 标注 ， 这 种 技术 对 于 为 我 们 的 应 
用 程序 中 增加 安全 你 护 之 类 的 功能 特别 有 用 。 


[1] http://stripesframework.org/display/stripes/Lifecycles+Etc. 


附录 A Hibernate% Æ! 


按照 数据 与 持久 化 服务 关系 的 不 同 ， 而 对 两 种 不 同 的 数据 进行 了 
基本 的 区 分 : 实体 和 值 。 


实体 有 它 目 己 独 立 的 存在 ， 而 不 考虑 当前 在 Java 虚 拟 机 中 有 是否 有 任 
何 对 象 引 用 了 它 。 通 过 查询 可 以 从 数据 库 中 检索 回 实体 ， 它 们 必须 由 
应 用 程序 显 式 地 保存 和 删除 (如 果 已 经 建立 了 级 联 关系 ， 对 父 实 体 的 
保存 或 删除 动作 也 会 触发 它 的 于 对 象 的 保存 或 删除 。 但 从 父 实 体 的 角 
度 来 看 ， 这 种 级 联 仍然 是 显 式 的 ) 。 


值 只 是 保存 为 实体 的 持久 化 状态 的 一 部 分 。 它 们 没有 自己 的 独立 
存在 。 值 可 以 是 原始 类 型 、 集 合 或 者 用 户 目 定义 的 类 型 。 因 为 它们 完 
全 从 属于 赖 以 存在 的 实体 ， 所 以 它们 不 能 被 独立 地 加 上 版 本 信息 ， 也 


不 能 被 多 个 实体 或 集合 共享 。 


注意 ， 某 个 特定 的 Java 对 象 既 可 能 是 实体 ， 也 可 能 是 值 。 区 别 在 于 
它 的 设计 方式 ， 以 及 它 是 如 何 提供 给 持久 化 服务 的 。 原 始 Java 类 型 总 十 
值 。 


基本 值 类 型 


这 里 只 是 简单 地 列举 了 一 些 有 关内 建 类 型 的 信息 ， 演 示 了 它们 怎 
么 将 Java 类 关联 到 SQL 的 字段 类 型 。 我 们 提供 了 数据 库 之 间 存 在 着 的 差 
异 的 例子 ， 但 不 打算 列举 每 种 差异 。 有 关 权 威 性 的 细 克 描述 ， 可 以 查 
看 org.hibernate.dialect 中 所 有 数据 库 方言 实现 的 源 代码 (查找 register- 
ColumnType () 调用 ) 。 


Hibernate 的 基本 类 型 可 以 大 致 分 为 : 
简单 数字 和 Boolean 类 型 


这 些 类 型 都 对 应 于 Java 的 原始 类 型 ， 可 以 代表 数字 、 字 符 、 
Boolean 值 或 者 其 封装 类 型 ， 它 们 要 映射 到 适当 的 SQL 字段 类 型 (基于 
使 用 的 SQL 方言 ) 。 这 些 类 型 是 : boolean、byte、character、double、 
float、integer、long、short、true_false 以 及 yes_no。 最 后 两 种 类 型 是 
Boolean 值 在 数据 库 中 的 另外 两 种 表示 形式 ，true_false 使 
用 "T" 和 "F" 值 ， 而 yes_no 则 使 用 "Y" 和 "N" 值 。 


Hibernate 类 型 string 可 以 将 java.lang.String 映 射 到 与 SQL 方 言 相应 的 
SERB SE RK AY (通常 是 YARCHAR， 或 者 是 Oracle 的 VARCHAR2) ° 


日 期 类 型 


Hibernate 使 用 date、time 以 及 timestamp， 将 java.util.Date (及 其 子 
K) 映射 到 相应 的 SQL 类 型 (例如 DATE、TIME、TIMESTAMP) 。 
timestamp 实 现 使 用 的 是 Java 环 境 中 的 当前 时 间 ; 除了 使 用 
dbtimestamp， 你 也 可 以 使 用 数据 库 对 当前 时 间 的 符号 表示 方法 。 如 果 
你 比较 喜欢 使 用 更 方便 的 java.util.Calendar 类 ， 在 编写 自己 的 代码 时 也 
不 需要 将 它 和 Date 类 型 的 值 来 回转 换 ， 你 可 以 用 calendar (这 个 类 型 将 
日 期 和 时 间 保 存 为 TIMESTAMP) 或 calendar_date (这 个 类 型 只 接受 日 
期 部 分 ， 上 映射 为 DATE 字 上 段 类 型 直接 进行 映射 。 


任意 精度 的 数字 类 型 


Hibernate 的 big_decimal 类 型 提供 从 java.math.BigDecimal 到 相应 的 
SQL 类 型 之 间 的 映射 《通常 是 NUMERIC， 但 Oracle 使 用 NUMBER) 。 
Hibernate 的 big_integer 提 供 对 java.math.BigInteger 的 映射 《通常 映射 到 
BIGINT， 但 Informix 称 之 为 INT8，Oracle 则 再 次 使 用 NUMBER) 。 


本 地 化 值 


Hibernate 类 型 locale、timezone 以 及 currency 保 存 为 字符 串 
(VARCHAR 或 VARCHAR2) ， 并 被 映射 到 java.util 包 中 的 Locale、 
TimeZone 以 及 Currency 类 。Locale 和 Currency 的 实例 用 它们 的 ISO 代码 
进行 傈 存 ， 而 TimeZone 则 用 它 鸭 ID 属性 进行 保存 。 


Class 名 称 


Hibernate 的 class 类 型 将 java.lang.Class 的 实例 映射 为 它 的 完全 限定 
的 名 称 ， 保 存在 字符 串 类 型 的 字段 中 (VARCHAR， 或 者 Oracle 中 的 
VARCHAR2) 。 


FTAA 


binary 类 型 将 字 节 数组 (byte array) 映射 为 对 应 的 SQL 二 进 制 类 
型 。 可 序列 化 对 象 serializable 类 型 用 于 将 可 序列 化 的 Java 类 型 映射 到 对 
应 的 SQL 二 进 制 类 型 。 这 是 一 种 后 备 类 型 ， 当 一 个 对 象 没 有 更 合适 的 
特定 持久 化 映射 时 《而 且 也 不 想 为 它 实 现 一 个 UserType 目 定义 映射 ， 参 
KR) ， 就 可 以 答 试 使 用 这 种 类 型 。 该 类 型 映射 到 的 SQL 类 型 与 
binary 的 映 喘 类 型 相同 ， 稍 后 将 加 以 介绍 。 


JDBC 大 型 数据 对 象 


blob 和 clob 类 型 为 java.sql 包 中 的 Blob 和 Clob 类 提供 映射 。 如 果 你 正 
在 处 理 真 正 的 大 型 数据 对 象 ， 最 好 是 将 这 些 属性 声明 为 Blob 或 Clob， 
即便 这 样 会 在 数据 对 象 中 需要 增加 一 个 显 式 的 JDBC 依 赖 。 通 过 
Hibernate 可 以 方便 地 利用 JDBC 的 功能 来 延迟 加 载 属性 值 ， 只 有 在 需要 
的 时 候 才 加 载 这 些 大 型 数据 对 象 。 


如 果 你 不 担心 数据 的 体积 太 庞大 ， 就 可 以 不 必 使 用 这 种 直接 的 
JDBC 接 口 ， 只 要 将 属性 类 型 声明 为 String 或 byte[]， 再 将 它 用 text 或 
binary 进 行 映射 。 这 些 类 型 分 别 对 应 于 SQL 类 型 的 CLOB 和 VARBINARY 


(在 Oracle 中 是 RAW， 在 PostgreSQL 中 则 是 BYTEA) 。 当 加 载 对 象 
时 ， 也 会 立即 将 这 些 值 加 载 到 各 个 属性 中 。 


目 定 义 值 类 型 


除了 将 对 象 映 射 为 实体 ， 也 可 以 创建 目 定 义 的 类 ， 将 它们 映射 为 
数据 库 中 其 他 实体 的 值 ， 而 不 能 目 己 独 立 存在 。 实 现 这 种 映射 ， 简 单 
的 话 ， 只 要 改变 现 有 类 型 的 映射 方式 束 可 以 了 (可 能 你 想 使 用 一 种 不 
同 的 字段 类 型 或 表示 方式 ) ; 复杂 的 话 ， 就 需要 将 一 个 值 划 分 到 多 个 
TRP” 


虽然 在 映射 文档 中 可 以 在 个 别 的 基础 上 ， 一 个 个 地 来 实现 映射 ， 
但 为 了 遵循 尽 可 能 避免 代码 重复 的 原则 ， 应 该 将 要 在 多 处 使 用 的 类 型 
封装 到 一 个 真正 可 重用 的 类 中 。 目 定义 的 类 可 以 实现 
org.hibernate.UserType 或 org.hibernate.CompositeUserType 接 口 。 第 6 章 对 
这 种 技术 进行 了 介绍 。 


用 这 种 方法 可 以 对 Java 5 的 enum (M) 类 型 (以 及 旧版 本 的 Java 
中 ， 手 工 编码 的 类 型 安全 的 枚 举 模式 的 实例 ) 进行 映射 。 可 以 用 一 种 
单独 的 、 可 重用 的 和 目 定义 类 型 映射 来 文 持 所 有 的 枚 举 类 型 ， 如 第 6 章 所 


yli o 


“任意 ”类型 映射 


后 介绍 一 种 非常 目 由 的 映射 。 本 质 上 ， 这 种 类 型 的 映射 可 以 将 
引用 区 蔡 映 射 到 其 他 多 种 映射 实体 。 和 需 要 提供 两 个 字段 ， 第 一 个 字 
段 包 含 每 个 引用 被 映射 到 的 表 的 名 称 ， 另 一 个 字段 则 提供 关注 的 特定 
实体 在 那个 表 中 的 ID 。 


sail 


在 这 种 松散 的 映射 天 系 中 ， 不 能 指定 任何 外 键 约束 。 其 实 ， 现 实 
中 很 少 需 要 这 种 类 型 的 映射 。 可 能 需要 使 用 这 种 映射 的 一 种 情况 是 ， 
如 膝 你 想 维护 一 个 审计 日 志 ， 它 可 能 包含 多 种 实际 的 对 象 。 参 考 手 册 
中 也 提 及 Web 应 用 程序 的 会 话 数据 也 是 男 一 种 潜在 的 使 用 情况 ， 但 古 这 
样 的 程序 似乎 不 可 能 是 一 种 结构 良好 的 应 用 程序 。 


所 有 类 型 


以 下 表格 列举 了 org.hibernate.types 包 中 文 持 的 所 有 类 型 ， 以 及 在 映 
喘 文 档 中 应 该 使 用 的 类 型 名 称 、 映 映 值 在 保存 时 可 能 使 用 的 最 常见 的 
SQL 类 型 、 有 关 类 型 作用 的 相关 注释 。 对 于 许多 映射 情况 ， 前 面 已 经 
做 了 更 详细 的 介绍 。 除 了 由 其 他 所 有 类 型 实现 的 Type 接口 ， 为 了 区 省 
页 面 空 间 ， 每 种 类 型 名 称 后 面 的 “类 型 ” (Type) 一 词 就 省 略 掉 了 。 


类 型 


AbstractBynary 
(或 许 也 可 以 指 


byte/binary/array? ) 
AbstractCharArray 


AbstractComponent 


(接口 ) 
Abstract 


Any 
Array 


Association 〈 接 口 ) 


Bag 
BigDecimal 
BigInteger 
Binary 

Blob 

Boolean 

Byte 
CalendarDate 
Calendar 
Character 
CharacterArray 
CharArray 


类 型 名 称 


N/A 


N/A 
N/A 


N/A 

any 

array 

N/A 

bag 
big_decimal 
big_integer 
binary 

blob 
boolean 
byte 
calendar_date 
calendar 
character 
N/A 

N/A 


SQL 类 型 


N/A 


N/A 
N/A 


N/A 

N/A 

N/A 

N/A 

N/A 
NUMERIC 
BIGINT 
VARBINARY 
BLOB 

BIT 
TINYINT 
DATE 
TIMESTAMP 
CHAR 
VARCHAR 
VARCHAR 


注释 
封装 用 于 将 字 节 流 绑 定 到 VARBINARY- 风 格 的 字段 类 型 的 代码 


封装 用 于 将 字符 流 绑 定 到 VARCHAR- 风 格 的 字段 类 型 的 代码 
让 Component 类 型 可 以 保存 集合 、 级 联 等 


内 建 类 型 使 用 的 抽象 框架 

支持 “any” 类 型 映射 

将 Java 数 组 映射 为 持久 化 集合 

支持 实体 间 的 关联 

用 bag 语 义 对 集合 进行 映射 

在 Oracle 中 ， 对 应 的 SQL 类 型 是 NUMBER 

在 Oracle 中 ， 对 应 的 SQL 类 型 是 NUMBER; Informix 则 使 用 INT8 
字 节 数组 的 基本 类 型 ， 非 延迟 加 载 (详细 参阅 本 附录 ) 
链接 到 JDBC， 支 持 延 迟 加 载 的 字 节 数组 

基本 原始 类 型 

映射 Calendar， 忽 略 时 间 

映射 Calendar， 包 括 时 间 

一 种 基本 的 原始 类 型 

映射 Character[ ] 属性 

映射 char[ ] 属性 


类 型 


CharBoolean 


Class 


Clob 

Collection 
Component 
CompositeCustom 


Currency 


Custom 

Date 

DbTimestamp 
Discriminator (接口) 


Double 


EmbeddedComponent 


Entity 

Float 

Identifier (接口 ) 
IdentifierBag 


类 型 名 称 


N/A 


class 


clob 
N/A 
component 
N/A 


currency 


N/A 
date 
dbtimestamp 


N/A 


double 
composite - 
element 
N/A 

float 

id 

idbag 


SQL 类 型 


CHAR 
VARCHAR 或 
VARCHAR2 
CLOB 

N/A 

N/A 

N/A 
VARCHAREK 
VARCHAR2 
N/A 

DATE 
TIMESTAMP 
N/A 


DOUBLE 
N/A 


N/A 
FLOAT 
N/A 
N/A 


注释 
用 于 实现 yes_no 和 true_false 类 型 的 抽象 框架 
用 于 存储 类 名 称 的 基本 类 型 


链接 到 JDBC， 支 持 延 迟 加 载 的 字符 数组 

支持 所 有 的 持久 化 集合 类 型 

将 包含 的 值 类 的 各 属性 映射 到 一 组 字段 

调整 CompositeUserType 的 实现 ， 以 支持 一 定 的 Type 接口 
为 Currency 存 储 其 ISO 

代码 

调整 UserType 的 实现 ， 以 支持 一 定 的 Type 接口 

基本 原始 类 型 

基本 原始 类 型 ， 使 用 数据 库 表示 的 “now” 

为 用 于 实现 鉴别 器 (discriminator) 属性 的 类 型 标识 其 接口 
(选择 正确 的 映射 子 类 ) 

基本 原始 类 型 

在 映射 内 声明 特定 的 ComponentType 


表示 到 另 一 个 实体 的 引用 
为 用 于 保存 实体 的 标识 符 的 类 型 标记 其 接口 
用 bag 语 义 映射 一 个 Collection 及 其 标识 符 字段 


( 续 ) 


Immutable N/A N/A 恒定 类 型 Cimmutable type) 的 抽象 超 类 ; 扩展 NullableType 


Integer integer INTEGER 基本 原始 类 型 
List list N/A 映射 Java 的 List 
Literal (接口 ) N/A N/A 为 用 于 保存 SQL 字 面值 
(literal) 的 类 型 而 标识 其 接口 
Locale locale VARCHAR 或 为 locale 〈 本 地 化 ) 保存 其 ISO 代码 
VARCHAR2 
Long long LONG 基本 原始 类 型 
ManyToOne many-to-one N/A 实体 之 间 的 一 种 关联 
Map map N/A 映射 Java 的 Map 
Meta meta-type N/A 为 使 用 any 的 多 态 映射 保存 其 鉴别 器 Cdiscriminator ) 的 值 
Mutable N/A N/A 非 恒定 类 型 (mutable type) 的 抽象 超 类 
Nullable N/A N/A 简单 的 、 可 以 为 null 的 字段 类 型 的 抽象 超 类 
OneToOne one-to-one N/A 实体 之 间 的 一 种 关联 
OrderedMap N/A N/A MapType 的 扩展 ， 以 保留 SQL 排序 
OrderedSet N/A N/A SetType 的 扩展 ， 以 保留 SQL 排序 
Primitive N/A N/A 用 于 映射 原始 Java 类 型 的 抽象 框架 ， 扩展 了 ImmutableType 
Serializable serializable Binary (see JDBC 可 序列 化 类 没有 更 好 的 映射 选择 时 ， 可 以 用 这 种 映射 
Large Objects earlier) 
Set set N/A 映射 Java 的 Set 
Short short SMALLINT 基本 原始 类 型 
SortedMap N/A N/A MapType 的 扩展 ， 以 利用 Java 的 有 序 集合 
SortedSet N/A N/A SetType 的 扩展 ， 以 利用 Java 的 有 序 集合 
( 续 ) 
类 型 类 型 名 称 SQL 类 型 注释 
String string VARCHAR or 基本 原始 类 型 
VARCHAR2 
Text text CLOB 将 CLOB 字 段 以 非 延 迟 方式 加 载 到 一 个 String 类 型 的 属性 中 (参见 
上 述说 明 ) 
Time time TIME 基本 原始 类 型 
TimeZone timezone VARCHAR or 保存 时 区 ID 
VARCHAR2 
Timestamp timestamp TIMESTAMP 基本 原始 类 型 ， 使 用 JVM 表 示 的 “now?” 
TrueFalse true_false CHAR 将 Boolean 值 保存 为 “T” 或 者 “F” 
Type (接口 ) N/A N/A 所 有 类 型 的 超级 接口 (superinterface) 
Version (接口 ) N/A N/A 为 版 本 惟 Cversion stamp) 而 扩展 Type 
WrapperBinary N/A N/A 这 个 类 型 好 像 还 没有 定义 好 
YesNo yes_no CHAR 将 Boolean 值 保存 为 “Y” 或 “N?” 


还 有 一 个 TypeFactory 类 ， 在 为 给 定 的 需要 而 构建 正确 的 Type 实现 时 ， 可 以 用 它 来 提供 帮助 ， 例 如 ， 在 映射 文档 中 解析 一 个 类 
型 名 称 时 。 阅 读 一 下 它 的 源 代码 也 很 有 趣 。 


TKB Criteria API 


Criteria 查 询 首先 使 用 createCriteria () 方法 从 Session 中 获取 一 个 
Criteria 对 象 ， 并 标明 执行 查询 的 对 象 “主要 的 类 ， 也 就 是 数据 表 ) ° 
之 后 再 通过 下 面 介绍 的 各 种 工厂 方法 为 Criteria 附 加 上 约束 条 件 、 投 影 
以 及 排序 ， 这 样 它 就 可 以 成 为 一 个 功能 非常 强大 而 方便 的 查询 接口 
了 。 


Criterion 工 厂 


Restrictions 可 以 作为 创建 Criterion 实 例 的 工 三， 用 于 限制 从 条 件 查 
询 中 返回 的 对 象 (记录 行 ) 。Restrictions 定 义 了 一 组 静态 方法 ， 通 过 调 
用 这 些 方法 并 传递 一 定 的 参数 ， 就 可 以 方便 地 创建 在 Hibernate 中 使 用 
的 标准 Criterion 实 现 。 这 些 碍 询 条 件 用 于 决定 在 查询 结 采 中 节 终 包含 哪 
些 来 自 数据 库 的 持久 化 对 象 。 下 表 总 结 了 Restrictions 工 厂 方法 可 以 提供 
的 选择 。 


方法 


allEq 


and 


between 


conjunction 


Map properties 


Criterion lhs, 


Criterion rhs 


String property, 


Object low, 
Object high 
无 


目的 


让 多 个 属性 的 取 值 为 特定 值 的 快捷 方式 。Map 对 象 中 的 键 
是 需要 加 以 限制 的 属性 的 名 称 ， 而 Map 中 的 相应 值 则 是 每 
个 属性 必须 等 于 的 目标 取 值 (如 果 某 个 实体 要 包含 在 查询 
结果 中 的 话 )。 返 回 的 Criterion 可 以 确保 每 个 指定 的 属性 都 
有 具有 相应 的 取 值 

创建 一 个 组 合 Criterion， 只 有 当 它 的 两 个 Criterion 代 表 的 条 
件 都 满足 时 ， 整 个 条 件 才 满 足 。 也 可 以 参阅 conjunction( ) 
要 求 指 定 属性 的 取 值 应 该 落 在 参数 1ow 和 

high 指 定 的 值 的 范围 内 


创建 一 个 Conjunction 对 象 ， 可 以 用 它 来 创建 任意 数目 的 
“and” 关 系 的 查询 条 件 。 只 需要 简单 地 调用 它 的 add( ) 方 法 ， 


方法 


disjunction 


eq 


eqProperty 


ge 


geProperty 


gt 


gtProperty 


idEq 
ilike 


ilike 


String property, 
Object value 
String property |, 
String property2 
String property, 
Object value 
String property|, 
String property2 
String property, 
Object value 
String property|, 
String property2 
Object value 
String property, 
Object value 
String property, 
String value, 
MatchMode mode 


( 续 ) 
目的 


并 提供 需要 检查 的 每 个 Criterion 实 例 。 当 且 仅 当 Conjunction 
中 的 每 个 子 查询 组 件 都 为 true 时 ，Conjunction 才 为 true。 与 使 
用 and( ) 方 法 来 手工 构建 查询 条 件 的 树 状 结构 相 比 ， 
Conjunction 更 方便 一 些 。Criteria 接 口 的 add( ) 方 法 看 起 来 表 
明 它 内 部 也 包含 了 一 个 Conjunction 

创建 一 个 Disjunction 对 象 ， 可 以 用 它 来 创建 任意 数目 的 
“or” 关 系 的 查询 条 件 。 只 需要 简单 地 调用 它 的 add( ) 方 法 ， 
并 提供 需要 检查 的 每 个 Criterion 实 例 。 如 果 Disjunction 中 的 
任何 一 个 子 查询 组 件 为 true，Disjunction 就 为 true。 与 使 用 
or( ) 方 法 来 手工 构建 查询 条 件 的 树 状 结构 相 比 ，Disjunction 
更 方便 一 些 。 相 关 示 例 可 以 参阅 例 8-10 

要 求 指定 属性 具有 特定 的 值 


要 求 两 个 指定 属性 的 取 值 相同 


要 求 指定 属性 的 值 大 于 或 等 于 指定 的 值 


要 求 第 一 个 指定 的 属性 的 取 值 大 于 或 等 于 第 二 个 属性 的 取 什 


要 求 指定 属性 的 取 值 大 于 特定 的 值 


要 求 第 一 个 指定 属性 的 取 值 大 于 第 二 个 属性 的 取 值 


要 求 标 识 符 〈identifier) 属性 等 于 指定 的 值 
大 小 写 不 敏感 的 “like” 运 算 符 ， 参 见 “1like” 


大 小 写 不 敏感 的 “like” 运 算 符 ， 供 不 喜欢 复杂 的 “like” 
语法 ， 只 需要 匹配 一 定 的 子 字符 串 的 用 户 使 用 。MatchMode 
是 一 个 类 型 安全 的 枚 举 值 ， 可 选取 的 值 为 START、END、 
ANYWHERE 以 及 EXACT。 这 个 方法 会 根据 mode 属 性 指 
定 的 匹配 模式 来 调整 value 的 语法 结构 ， 接 着 再 像 两 个 参数 
的 ilike( ) 方 法 那样 进行 处 理 


方法 


isEmpty 
isNotEmpty 
isNotNull 
isNull 

le 


leProperty 


like 


like 


ItProperty 


naturalld 


ne 


neProperty 


not 


参数 


String property, 


Collection values 


String property, 
Object[] values 


String property 
String property 
String property 
String property 
String property, 
Object value 
String property|, 
String property2 
String property, 
Object value 


String property, 
String value, 
MatchMode mode 
String property, 
Object value 
String property 1, 
String property2 


None 


String property, 
Object value 
String property 1, 
String property2 


Criterion expression 


( 续 ) 
目的 


要 求 指定 的 属性 取 值 可 以 选取 集合 中 包含 的 任意 值 。 与 手 
工 建立 eq( ) 查 询 条 件 的 disjunction( ) 方 法 相 比 ， 这 个 方法 更 
方便 

要 求 指定 的 属性 取 值 可 以 选取 数组 中 包含 的 任意 值 。 与 手 
工 建立 eq( ) 查 询 条 件 的 disjunction( ) 方 法 相 比 ， 这 个 方法 更 
方便 

要 求 指 定 的 集合 属性 是 空 的 《成 员 个 数 为 0) 

要 求 指定 的 集合 属性 至 少 要 有 一 个 元 素 

要 求 指定 的 属性 不 能 包含 null 值 

要 求 指定 的 属性 为 null 

要 求 指定 的 属性 小 于 或 等 于 特定 的 值 。 参 见 例 8-3 


要 求 指定 的 第 1 个 属性 小 于 或 等 于 第 2 个 属性 


要 求 指定 的 属性 “1like” 于 特定 的 值 (从 SQL like 运 算 符 的 
意义 上 来 说 ， 它 支持 简单 的 子 字 符 串 匹配 )。 参 见 例 8-8 和 
例 8-16 

为 不 喜欢 复杂 的 “like” 运 算 符 语法 ， 只 想 匹 配 一 定 的 子 字 
符 串 的 人 提供 的 “like” 运 算 符 。 更 多 细节 请 参阅 ilike( ) 
方法 

要 求 指 定 的 属性 小 于 特定 的 值 


要 求 指定 的 第 1 个 属性 小 于 第 2 个 属性 

支持 通过 <natural-id> 了 映射 的 多 列 “自然 业务 键 ”(Cnatural 
business key) 的 选择 

要 求 指定 的 属性 不 能 取 特 定 的 值 


要 求 指定 的 两 个 属性 具有 不 同 的 值 


对 给 定 的 Criterion 求 反 (如 果 Criterion 匹 配 ， 则 为 false， 反 
之 亦 然 ) 


方法 


OT 


sizeEq 


sizeGe 


sizeGt 


sizeLe 


sizeLt 


sizeNe 


sqlRestriction 


sqlRestriction 


sqlRestriction 


当 为 sqlRestriction () 方法 指定 查询 语句 文本 时 ， 


参数 


Criterion lhs, 


Criterion rhs 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String property, 


int size 


String sql 


String sql, 


Object[] values, 


Type[] types 
String sql, 
Object value, 
Type type 


E) 
目的 
构建 一 个 复合 Criterion, 只 要 它 的 任意 一 个 子 Criterion 匹 配 ， 
则 该 复合 条 件 就 成 功 。 参 见 disjunction( ) 
要 求 指定 的 集合 属性 具有 特定 数量 的 子 元 素 


要 求 指定 的 集合 属性 至 少 包 含 一 个 特定 的 元 素 


要 求 指定 的 集合 属性 的 成 员 个 数 大 于 特定 的 值 


要 求 指定 的 集合 属性 的 成 员 个 数 不 超过 特定 的 值 


要 求 指定 的 集合 属性 的 成 员 个 数 少 于 特定 的 值 


要 求 指定 的 集合 属性 中 互 不 相同 的 成 员 的 个 数 超过 size 
采用 底层 数据 库 系统 的 原生 SQL 方言 来 表达 限制 条 件 。 虽 
然 这 个 功能 强大 ， 但 要 小 心 因此 而 失去 可 移植 性 的 意义 
采用 底层 数据 库 系 统 的 原生 SQL 及 多 个 JDBC 参 数 来 表达 限 
制 条 件 。 虽 然 这 个 功能 强大 ， 但 要 小 心 因 此 而 失去 可 移植 
性 的 意义 

采用 底层 数据 库 系统 的 原生 SQL 及 JDBC 人 参数 来 表达 限制 条 
件 。 虽 然 这 个 功能 强大 ， 但 要 小 心 因 此 而 失去 可 移植 性 的 
意义 


查询 语句 中 出 现 


的 任何 "{falias}" 字 符 串 都 将 由 执行 得 询 涉及 的 数据 表 的 实际 别名 所 取 


iB 


任 


o 


局 


这 些 方 
意 复 杂 程 


AR 


法 中 的 多 数 都 以 Criterion 实 例 作 为 参数 ， 可 以 按照 你 需要 的 


度 来 构建 复合 条 件 查询 树 。 


过 conjunction () 和 


disjunction () 返回 的 对 象 可 以 方便 地 添加 新 的 查询 条 件 ， 多 次 调用 

add () 方法 可 以 添加 任意 多 个 条 件 。 不 过 ， 如 果 查 询 足 够 复杂 有 的话 ， 

用 HQL 进 行 查询 可 能 更 容易 表达 和 理解 。 还 有 小 量 的 查询 种 类 用 这 种 
API 无 法 提供 支持 ， 所 以 不 可 能 总 能 避免 使 用 HQL。 但 古 这 种 情况 会 越 
来 越 少 ， 大 多 数 这 类 基本 的 查询 在 应 用 程序 开发 的 整个 过 程 中 都 会 用 
到 ， 而 用 这 种 API 来 表达 位 单 的 查询 也 非常 目 然 和 容易 ， 同 时 也 让 Java 
代码 变 得 更 加 可 读 和 傈 涪 ， 并 在 编译 时 就 检查 代码 是 否 正 确 。 


Projection L) 


Hibernate 提 供 的 org.hibernate.criterion.Projections 可 以 作为 创建 投影 
实例 的 工厂 ， 用 投影 可 以 缩小 从 条 件 碍 询 中 返回 的 属性 〈 列 ) 的 个 
数 ， 以 及 计算 聚合 (aggregate) 值 。 可 以 调用 投影 类 提供 的 静态 方 
法 ， 并 使 用 提供 的 参数 来 方便 地 创建 Hibernate 中 使 用 的 标准 投影 实 
现 。 这 些 投影 用 于 缩小 查询 结果 中 属性 的 范围 、 对 属性 进行 分 组 或 转 
换 。 以 下 列举 了 Hibernate 提 供 的 一 些 可 用 选项 。 


四 
alias 
avg 
count 


countDistinct 


distinct 
groupProperty 
id 

max 

min 


projectionList 


property 


rowCount 


sqlGroupProjection 


sqlProjection 


sum 


Order] 


参数 


Projection projection, 
String alias 

String property 
String property 
String property 


Projection projection 


String property 


None 


String property 
String property 


None 


String property 
None 

String sql, String 
groupBy, String[] 
columnAliases, 
Type[] types 
String sql, String[] 
columnAliases, 
Type[] types 
String property 


目的 


为 投影 指派 一 个 别名 名称 )， 以 便 在 Criteria 查 询 
的 其 他 地 方 可 以 引用 该 投影 (例如 分 组 、 排 序 等 ) 
计算 指定 属性 的 平均 值 

计算 在 结果 中 指定 属性 出 现 的 次 数 

计算 在 结果 中 取 值 不 相同 的 指定 属性 出 现 的 次 数 
让 投影 查询 只 返回 具有 惟一 值 的 记录 《去掉 取 值 重 
复 的 记录 ) 

按 指定 的 属性 对 查询 结果 进行 分 组 〈 可 与 聚合 值 计 
算 一 起 使 用 )。 参 见 例 8-15 

将 对 象 的 标识 符 作为 投影 的 一 个 元 素 〈 不 论 标 识 符 
属性 的 名 称 是 什么 ) 

计算 指定 属性 的 最 大 值 。 参 见 例 8-15 

计算 指定 属性 的 最 小 值 

创建 一 个 新 的 投影 列表 ， 用 于 请 求 多 个 投影 值 。 参 
见 例 8-14 

在 投影 中 包括 指定 的 属性 。 参 见 例 8-13 

计算 返回 结果 中 的 记录 行 的 个 数 。 参 见 8-15 

支持 使 用 数据 库 特 定 的 SQL 代码 来 执行 投影 ; 
groupBy 可 以 包含 一 个 SQL “GROUP BY” 子 句 。 
这 里 需要 告诉 Hibernate 投 影 中 返回 列 的 别名 和 类 型 


支持 使 用 数据 库 特 定 的 SQL 代码 来 执行 投影 ， 可 以 
使 用 上 面 的 groupProperty( ) 投 影 来 执行 分 组 。 这 里 
需要 告诉 Hibernate 投 影 中 返回 列 的 别名 和 类 型 
计算 指定 属性 值 的 代数 和 


可 以 让 Hibernate 〈 它 再 让 底层 的 数据 库 系统 ) 对 查询 结果 按 一 定 
的 顺序 进行 排序 。org.hibernate.criterion.Order 类 代表 这 些 排 序 请 求 ， 提 


供 了 两 个 静态 工厂 方法 用 于 创建 实例 ， 再 将 这 些 实例 附加 到 条 件 查 询 
中 。 在 获得 Order 实 例 后 ， 如 果 需 要 让 结果 排序 不 区 分 字母 大 小 写 ， 则 
可 以 调用 Order 实 例 上 的 非 静态 方法 ignoreCase () 。 


方法 参数 目的 

asc String property 按照 指定 属性 的 升序 排列 对 结果 进行 排序 。 参 见 例 8-6 

desc String property 按照 指定 属性 的 降序 排列 对 结果 进行 排序 
Property L] 


在 目前 介绍 的 方法 中 ， 都 是 先 按照 感 兴趣 的 内 容 来 创建 条 件 查 
询 、 投 影 或 者 排序 实例 ， 再 将 查询 涉及 的 属性 名 称 作为 参数 传递 给 相 
天 方法 。Criteria API 也 文 持 用 与 上 述 相 反 的 方 回来 进行 处 理 ， 先 从 属 
性 开始 ， 再 调用 一 个 方法 来 构建 基于 该 属性 的 查询 或 投影 。 
org.hibernate.criterion.Property 是 一 个 创建 Property 实 例 的 工厂 ， 如 果 你 
喜欢 后 面 这 种 构建 查询 的 方法 ， 束 可 以 使 用 这 个 类 。Property 定 义 了 一 
个 静态 的 forName O 方法 ， 调 用 它 就 可 以 创建 一 个 代表 特定 属性 的 实 
例 。 在 获得 实例 以 后 ， 就 可 以 再 调用 该 实例 提供 的 方法 来 创建 基于 它 
代表 的 属性 上 的 条 件 查 询 、 投 影 以 及 排序 。 本 书 这 里 只 列举 一 些 经 常 
使 用 到 的 方法 ， 省 略 介绍 的 方法 主要 与 离线 查询 (detached criteria) 和 
子 查询 有 关 ， 这 些 主题 已 经 超出 本 书 的 范围 。 当 你 需要 了 解 它们 时 ， 
可 以 看 看 《Java Persistence with Hibernate》 中 的 "Advanced query 


options" (高 级 查询 选项 ) 这 一 章 ， 或 是 在 线 参 考 文 档 中 的 "Detached 


queries and subqueries" (1!) (离线 查询 和 子 查询 ) 这 一 部 分 。 


JE 参数 目的 
asc None 创建 一 个 Order， 根 据 指定 属性 值 的 升序 顺序 对 查询 
结果 进行 排序 
avg None 创建 一 个 Projection， 返 回 属性 值 的 平均 值 
between Object min， 创建 一 个 Criterion， 要 求 属 性 值 介 于 min 和 max 之 间 
Object max 
count None 创建 一 个 Projection， 返 回 属性 值 在 查询 结果 中 出 现 的 


BO 


方法 


desc 


eq 
eqProperty 


eqProperty 


ge 
geProperty 


geProperty 


getProperty 


group 


gt 
gtProperty 


gtProperty 


isEmpty 


isNotEmpty 


isNotNull 


isNull 


le 


None 


Object value 


Property other 


String property 


Object value 
Property other 


String property 


String property 


None 


Object value 


Property other 


String property 


Collection values 


Object[] values 


None 


None 


None 


None 


Object value 


( 续 ) 


目的 
创建 一 个 Order， 根 据 指定 属性 值 的 降序 顺序 对 查询 
结果 进行 排序 


创建 一 个 Criterion， 要 求 属性 值 等 于 提供 的 值 
创建 一 个 Criterion， 要 求 属 性 值 等 于 另 一 个 由 other 代 
表 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 等 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 大 于 或 等 于 指定 的 值 2 
创建 一 个 Criterion， 要 求 属性 值 大 于 或 等 于 另 一 个 由 
other 代表 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 大 于 或 等 于 另 一 个 其 
名 称 由 property 指 定 的 属性 值 

从 当前 属性 中 提取 指定 名 称 的 复合 属性 元 素 〈 假 定 当 
前 属性 是 一 个 复合 属性 )。 返 回 另 一 个 Property 实 例 
创建 一 个 Projection， 要 求 按 当前 属性 值 对 查询 结果 进 
行 分 组 

创建 一 个 Criterion， 要 求 属 性 值 大 于 指定 的 值 2 
创建 一 个 Criterion ， 要 求 属 性 值 大 于 另 一 个 由 other 代 
表 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 大 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 包含 于 提供 的 集合 和 
创建 一 个 Criterion， 要 求 属 性 值 应 该 等 于 提供 的 数组 


中 的 某 个 元 素 

创建 一 个 Criterion， 要 求 属性 应 该 为 空 (包含 0 个 元 素 
的 集合 ) 

创建 一 个 Criterion， 要 求 属性 应 该 为 至 少 包含 一 个 元 
素 的 集合 


创建 一 个 Criterion， 要 求 属性 值 不 能 为 null 
创建 一 个 Criterion， 要 求 属性 值 为 null 
创建 一 个 Criterion， 要 求 属性 值 小 于 或 等 于 指定 的 值 2 


方法 


leProperty 


leProperty 


like 


like 


It 


ItProperty 


ItProperty 


ne 


neProperty 


neProperty 


参数 


Property other 


String property 


Object value 


String value， 


MatchMode mode 


Object value 


Property other 
String property 
None 

None 

Object value 


Property other 


String property 


( 续 ) 


目的 
创建 一 个 Criterion， 要 求 属 性 值 小 于 或 等 于 另 一 个 由 
other 代表 的 属性 值 


创建 一 个 Criterion， 要 求 属性 值 小 于 或 等 于 另 一 个 其 
名 称 由 property 指 定 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 “like” 于 指定 的 值 
(从 SQL like 运 算 符 的 意义 来 说 ， 它 支持 简单 的 子 字符 
串 匹 配 ) 有 

供 不 喜 欢 复杂 的 “like” 语 法 ， 只 需要 匹配 一 定 的 子 
字符 串 的 用 户 使 用 的 “like” 方 法 。MatchMode 是 一 
个 类 型 安全 的 枚 举 值 ， 可 选取 的 值 为 START、END、 
ANYWHERE 以 及 EXACT。 这 个 方法 会 根据 mode 属 
性 指定 的 匹配 模式 来 调整 value 的 语法 结构 ， 接 着 再 像 
一 个 参数 的 like( ) 方 法 那样 进行 处 理 2 
创建 一 个 Criterion， 要 求 属 性 值 小 于 指定 的 值 2 

创建 一 个 Criterion， 要 求 属性 值 小 于 另 一 个 由 other 代 
表 的 属性 值 

创建 一 个 Criterion， 要 求 属 性 值 小 于 另 一 个 其 名 称 由 
property 指 定 的 属性 值 

创建 一 个 Projection， 返 回 当前 属性 的 最 大 值 
创建 一 个 Projection， 返 回 当前 属性 的 最 小 值 
创建 一 个 Criterion， 要 求 属性 值 不 能 取 指 定 的 值 2 
创建 一 个 Criterion， 要 求 属性 值 不 能 等 于 男 一 个 由 
other 代表 的 属性 值 

创建 一 个 Criterion， 要 求 属性 值 不 能 等 于 另 一 个 其 名 
称 由 property 指 定 的 属性 值 


注 : @ 该 方法 的 返回 类 (CountProjection) 有 一 个 setDistinct( ) 方 法 ， 如 果 需 要 统计 不 同属 性 值 的 个 数 ， 
则 可 以 调用 这 个 方法 。 

@ 该 方法 的 返回 类 (SimpleExpression) 有 一 个 ignoreCase( ) 方 法 ， 如 果 需 要 进行 不 区 分 大 小 写 的 
比较 ， 则 可 以 调用 这 个 方法 。 


[1] 
http://www.hibernate.org/hib_docs/v3/reference/en/html/querycriteria.html# 


querycriteria-detachedqueries. 


MKC Hibernate SQL 方言 


掌握 流利 的 SQL 方 言 


Hibermate 封 装 了 对 很 多 商业 (H) 和 人 免费 的 关系 数据 库 的 支持 。 
虽然 不 进行 这 些 配置 ， 大 多 数 功能 也 都 可 以 正常 运行 ， 但 是 将 
hibernate.dialect 配 置 属性 设置 成 正确 的 org.hibernate.dialect.Dialect 子 类 
具有 一 定 的 重要 性 ， 尤 其 是 在 使 用 诸如 native 或 sequence 主 键 生 成 以 及 
会 话 锁定 的 功能 时 。 如 果 你 指定 一 种 方言 ，Hibernate 将 为 一 些 配 置 参 
数 使 用 合理 的 默认 值 ， 为 你 省 去 了 手工 单独 指定 它们 的 麻 烦 。 


数据 库 系 统 相应 的 hibernate.dialect 设 置 
Caché 2007.1 org.hibernate.dialect.Cache7 | Dialect 
DB2 org.hibernate.dialect.DB2Dialect 
DB2 AS/400 org.hibernate.dialect.DB2400Dialect 
DB2 OS390 org.hibernate.dialect.DB2390Dialect 
Derby org.hibernate.dialect.Derby Dialect 
Firebird org.hibernate.dialect.FirebirdDialect 
FrontBase org.hibernate.dialect.FrontbaseDialect 
H2 org.hibernate.dialect.H2Dialect 
HSQLDB org.hibernate.dialect. HSQLDialect 
Informix org.hibernate.dialect.InformixDialect 
Ingres org.hibernate.dialect.IngresDialect 


Interbase org.hibernate.dialect.InterbaseDialect 


数据 库 系统 


JDataStore 

Mckoi SQL 

Mimer SQL 

Microsoft SQL Server 

MySQL (versions prior to 5.x) 

MySQL (version 5.x and later) 

MySQL (prior to 5.x, using InnoDB tables) 
MySQL (prior to 5.x, using MyISAM tables) 
MySQL (version 5.x, using InnoDB tables) 
Oracle (any version) 

Oracle 81 

Oracle 9i or 10g 

Oracle 10g only (use of ANSI join syntax) 
Pointbase 

PostgreSQL 

Progress 

SAP DB 

Sybase (or MS SQL Server) 

Sybase 11.9.2 

Sybase Anywhere 

Teradata 

TimesTen 5.1 

Unisys 2200 RDMS 


CÈ) 
相应 的 hibernate.dialect 设 置 


org.hibernate.dialect.JDataStore 
org.hibernate.dialect.MckoiDialect 
org.hibernate.dialect.MimerSQLDialect 

org. hibernate.dialect.SQLServerDialect 

org. hibernate.dialect.MySQLDialect 
org.hibernate.dialect.MySQL5Dialect 
org.hibernate.dialect MySQLInnoDBDialect 
org.hibernate.dialect. MySQLMyISAMDialect 
org.hibernate.dialect. MySQL5InnoDBDialect 
org.hibernate.dialect.OracleDialect 
org.hibernate.dialect.Oracle8iDialect 
org.hibernate.dialect.Oracle9Dialect 
org.hibernate.dialect.Oraclel0gDialect 
org.hibernate.dialect.PointbaseDialect 
org.hibernate.dialect.PostgreSQLDialect 
org.hibernate.dialect.ProgressDialect 
org.hibernate.dialect.SAPDBDialect 
org.hibernate.dialect.SybaseDialect 
org.hibernate.dialect.Sybase1 1 Dialect 
org.hibernate.dialect.Sybase Any whereDialect 
org.hibernate.dialect.TeradataDialect 
org.hibernate.dialect.TimesTenDialect 


org.hibernate.dialect. RDMSOS2200Dialect 


如 果 以 上 没有 你 需要 的 目标 数据 库 ， 可 以 检查 一 下 最 新 发 布 的 
Hibernate 是 否 已 经 提供 了 相关 的 文 持 。Hibernate 参 考 文档 的 "SQL 
Dialects" (1) 部 分 列 出 了 能 够 支持 的 大 部 分 SQL 方言 。 如 果 还 是 不 


行 ， 可 以 再 看 看 是 否 能 够 找到 其 他 第 三 方 对 相关 数据 库 的 支持 ， 或 首 
考虑 目 己 动手 开发 ! 


[1] 我 从 来 吏 没 有 指望 可 以 再 次 利用 到 缓存 中 的 东西 ， 还 是 把 软件 健壮 
性 的 问题 留 给 Java 吧 ..…...…. 
[2] http://www.hibernate.org/hib-docs/v3/reference/en/html/session- 


configuration.html#configuration-optional-dialects. 


BSD Spring 事务 文 持 
使 用 Spring Framework 上 的 事务 标注 


在 具体 的 类 或 者 接口 上 可 以 添加 Transactional 标 注 ， 为 类 或 方法 增 
加 事务 管理 。 如 果 用 Transactional 对 一 个 类 进行 标注 ， 其 设置 将 会 应 用 
到 类 中 定义 的 每 个 方法 。 如 果 用 Transactional 对 一 个 方法 进行 标注 ， 事 
务 设置 将 只 应 用 到 某 个 单独 的 方法 。 如 琳 对 类 和 方法 都 古 应 用 了 
Transactional 标 注 ， 对 方法 进行 的 标注 比 对 类 进行 的 标注 具有 更 高 的 优 
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通过 Transactional 标 注 ， 可 以 控制 事务 的 隔离 级 别 、 超 时 时 间 、 传 
播 (propagation) 设置 以 及 会 导致 事务 回 深 的 一 组 异常 。 例 如 ， 如 果 我 
们 希望 总 是 用 可 序列 化 的 隔离 级 别 创建 一 个 新 的 事务 ， 在 一 分 钟 之 内 
没有 完成 或 发 生 了 NumberFormatException 异 常 ， 就 回 深 事务 ， 就 可 以 
编写 类 似 例 D-1 所 示 的 代码 。 


例 D-1: 更 多 的 事务 配置 控制 选项 


@Transactional (readOnly=false, 
propagation=Propagation.REQUIRES_NEw, 
isolation=Isolation.SERIALIZABLE, 
rollbackFor={NumberFormatException.class}, 
timeout=60) 

public abstract void run () ; 


如 果 使 用 Transactional 标 注 ， 需 要 小 心 选择 标注 放置 的 位 置 。 如 果 
完 使 用 了 Spring 中 的 代理 ， 或 者 准备 要 人 研究 一 下 Spring 中 为 Aspect- 
Oriented Programming (AOP) 提供 的 引信 注目 的 支持 ， 你 需要 注意 尽 
可 能 避免 把 Transactional 标 注 放 到 接口 上 ， 还 需要 注意 要 将 Transactional 
标注 放 在 非 public 的 方法 上 。 在 这 个 示例 中 ， 因 为 我 们 没有 使 用 任何 
Spring 的 AOP 功 能 ， 所 以 就 把 Transactional 标 注 放 在 了 一 个 接口 上 。 如 
果 你 正在 为 一 个 系统 调试 错误 ， 其 中 省 略 了 Transactional 标 注 ， 这 时 需 
要 做 的 第 一 件 事情 就 是 验证 标注 过 的 方法 是 否 是 public 的 。 如 果 使 用 
AspectJ 或 早期 的 Spring AOP 功 能 ， 在 使 用 代理 或 AOP 时 ， 总 会 遇 到 些 
令 人 混淆 的 问题 。 如 果 决 定 使 用 Spring 的 AOP 功 能 ， 就 应 该 记得 务必 将 
@Transactional 标 注 放 在 具体 的 类 上 © 


注意 : 如 果 对 这 些 术 语 不 熟悉 ， 看 看 下 面 表 格 的 解释 会 有 帮助 。 
Transactional 标 注 属性 


表 D-1 列 举 了 Transactional 标 注 的 属性 。 


表 D-1: Transactional 标 注 的 属性 


表 D-1: Transactional 标 注 的 属性 


isolation Isolation 事务 隔离 设置 。 后 面 的 表 D-3 提 供 了 可 用 选 
项 的 更 多 细节 

noRollbackFor Class[] AKA TRES ARN RBA RRK). 

noRollbackForClassName String[] 可 以 指定 一 组 完全 限定 的 类 名 或 Class 对 象 

propagation Propagation 事务 传播 配置 。 有 关 这 一 配置 的 更 多 细节 ， 
可 以 参见 表 D-2 

readOnly boolean 指定 事务 是 只 读 的 ， 还 是 可 读 写 的 

rollbackFor Class[] 一 组 将 会 导致 事务 回 深 的 异常 类 (或 类 名 )。 

rollbackForClassName String[] RuntimeExceptions 的 默认 行为 就 是 会 触发 回 


深 ， 而 对 于 checked exception 则 通常 不 会 触 
发 回 深 。 如 果 抛 出 了 checked exception, Ff 
希望 因此 而 触发 回 深 ， 就 需要 把 这 个 异常 添 
加 到 rollbackFor 属 性 。 可 以 指定 一 组 完全 限 
定 的 类 名 或 Class 对 象 

timeout int 事务 超时 需要 经 过 的 秒 数 。 如 果 将 这 个 属性 
设置 为 - 1， 则 表示 事务 永远 不 会 超时 (无 
限 的 超时 时 间 ) 


Bo Te te 


propagation 属 性 用 于 告诉 Spring， 操 作 是 否 需 要 一 个 新 的 事务 、 骸 
套 事 务 或 者 还 是 在 现 有 的 事务 中 进行 操作 。 表 D-2 列 出 了 propagation 属 
性 的 有 效 取 值 。 


事务 的 传播 行为 依赖 于 事务 提供 着 。 如 果 你 正在 使 用 的 是 JTA,， 一 
KER FAIL, BA EG MIFRKEBS ° 


表 D-2: Propagation 枚 举 值 


值 描述 

Propagation.REQUIRED 使 用 现 有 的 事务 如 果 没 有 任何 事务 ， 就 创建 一 个 新 事务 
(这 是 默认 值 》 

Propagation.SUPPORTS 将 参与 到 现 有 的 事务 中 ; 如果 不 存 在 已 有 的 事务 ， 也 不 会 
创建 新 事务 

Propagation.MANDATORY 需要 提供 一 个 现 有 的 事务 ;如 果 不 存在 现 有 的 ， 则 抛 出 异常 


Propagation.REQUIRES_NEW 为 这 个 方法 创建 一 个 新 事务 ; 如 果 存 在 ， 则 挂 起 当前 事务 
Propagation.NOT_SUPPORTED 标注 方法 中 的 持久 化 操作 将 不 在 事务 中 执行 。 如 果 在 已 经 
有 的 事务 中 调用 该 方法 ， 则 该 事务 会 被 挂 起 


Propagation.NEVER 如 果 在 一 个 事务 当中 调用 该 方法 ， 则 抛 出 异常 
Propagation.NESTED 如 果 在 一 个 现 有 的 事务 中 调用 该 方法 ， 则 在 和 藤 套 事务 中 执 


行 该 标注 方法 


事务 隅 离 


Pasi 


isolation 属 性 可 以 控制 在 事务 中 需要 什么 锁 ， 以 及 数据 库 中 当前 正 
在 执行 的 事务 和 状态 对 事务 的 影响 。 表 D-3 列 举 了 isolation 属 性 的 有 效 
取 值 。 


表 D-3: Isolation 枚 举 值 


值 描述 
Isolation.DEFAULT 使 用 底层 数据 库 的 默认 隔离 级 别 
Isolation.SERIALIZABLE 提供 最 高 级 别 的 隔离 级 别 ， 不 能 读 取 “ 脏 ” 数 据 ， 不 能 


重复 读 取 ， 也 不 能 幻像 读 取 (phantom read)。 当 使 用 这 

种 隔离 级 别 时 ， 即 使 读 操作 也 需要 获得 锁 。 在 使 用 这 种 

隔离 级 别 〈 包 括 高 于 READ_UNCOMMITTED 以 上 的 隔 
离 级 别 ) 时 ， 应 该 小 心 避免 两 个 活动 事务 之 间 的 死 锁 
(deadlock) 冲突 

Isolation.REPEATABLE_READ 不 能 读 取 “ 脏 ” 数 据 和 重复 读 取 。 但 可 能 幻 读 

Isolation.READ_COMMITTED 不 能 读 取 “ 脏 ” 数 据 。 但 可 能 重复 读 和 幻 读 

Isolation.READ_UNCOMMITTED ”最低 级别 的 隔离 级 别 ， 一 个 事务 可 以 看 到 另 一 个 事务 未 
提交 的 修改 。 脏 读 、 重 复读 以 及 幻 读 在 这 个 级 别 内 都 有 
可 能 发 生 


在 真实 世界 的 系统 中 使 用 SERIALIZABLE 隔 离 级 别 也 经 常 是 不 现 
实 的 ， 因 为 对 数据 库 的 访问 不 会 全 部 都 “顺序 依次 ”发生 。 通 常 使 用 的 
是 REPEATABLE_READ 或 READ_COMMITTED 隔 离 级 别 ， 并 构建 一 些 
仿 测 死 锁 和 在 失败 后 尝试 重 新 操作 的 逻辑 代码 。 大 型 多 用 户 应 用 程序 

(例如 Web 网 站 ) 在 使 用 SERIALIZABLE 时 需要 当心 事务 死 锁 ， 如 果 使 
用 的 是 高 于 READ_UNCOMMITTED 的 任何 级 别 ， 就 应 该 确保 在 
Transactional 标 注 中 为 timeout 属 性 定义 了 一 个 有 限 的 超时 时 间 值 。 事 务 
隔离 的 具体 行为 会 依赖 于 正在 使 用 的 数据 库 ， 例 如 ，MySQL 的 InnoDB 
存储 引擎 对 事务 隔离 级 别 的 解释 就 与 Oracle、SQL Server、Derby 或 
HSQLDB 中 的 版 本 存在 一 些 差 异 。 


使 用 JTA 事 务 管 理 吉 


在 第 13 章 的 示例 中 ， 我 们 使 用 的 是 HibernateTransactionManager， 
因为 它 用 起 来 比较 直观 和 简单 。 如 果 需 要 使 用 JTA 来 参与 分 布 式 事务 ， 
或 者 处 理 跨越 多 种 技术 (JDBC+JMS) WES, 那么 在 
applicationContext.xml 中 可 以 用 其 他 东西 来 取代 transactionManager， 如 
例 D-2 所 示 。 


例 D-2: 配置 JTA 事 务 管理 器 


<! --enable the configuration of transactional behavior based on 
annotations- -> 

<tx:annotation-driven transaction-manager="transactionManager"/ 
> 

<bean id="transactionManager" 

class="org.springframework.transaction.jta.JtaTransactionManager" 
/> 


附 永 E Bae ete 


pd 


为 了 更 深入 地 控 据 Hibernate 的 能 力 ， 以 及 使 用 它 的 其 他 方法 ， 还 
有 许多 研究 学 习 的 渠道 。 以 下 束 介 绍 一 些 好 的 习 学 资产， 挑选 些 最 适 
合 你 需要 的 方法 ， 确 定好 你 的 学 习 风 格 和 时 间 安 排 。 


在 线 手册 


本 书 中 涉及 的 开发 工具 都 提供 了 不 错 的 在 线 文档 。 如 采 你 想 了 解 
一 下 这 些 开发 包 的 基本 用 法 ， 在 线 参考 手册 可 以 给 你 提供 有 关 如 何 完 
成 特定 任务 的 详细 介绍 。 在 每 个 开发 包 主 页 的 显著 位 置 上 都 可 以 找到 


Documentation 链 接 © 


Als 


由 Christian Bauer 和 Gavin King 编 著 的 《Java Persistence with 
Hibernate) (Manning Publications) 更 加 完整 而 详细 地 讨论 了 
Hibernate。 这 两 位 专家 作为 Hibernate 的 创作 者 ， 他 们 非常 熟悉 
Hibernate 的 细节 ， 不 过 有 时 也 运用 了 些 相 当 深奥 的 专业 的 数据 库 概 


pn 0 
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为 了 掌握 些 专业 知识 ， 你 也 可 以 阅读 一 下 George Reese 写 的 《Java 
Database Best Practices) (O'Reilly) ， 或 者 至 少 读 一 下 我 们 在 本 书 第 4 
章 中 提 到 的 相关 章节 〈《 有 在 线 文档 可 用 ) (H) 。 要 深入 研究 Apache 
Maven 的 使 用 ， 可 以 阅读 来 自 Sonatype 的 《Maven: The Definitive 
Guide》。 为 了 更 多 地 了 解 Apache Ant， 可 以 看 看 Jesse E.Tilly 和 Fric 
M.Burke 写 的 《Ant: The Definitive Guide) (O'Reilly) (1) ， 或 者 
是 读 一 下 最 近 由 Steve Loughran 和 Erik Hatcher 写 的 《Ant in Action》 


(Manning) 


有 天 Spring Framework 的 更 多 信息 ， 可 以 选择 参考 由 Bruce Tate 和 
Justin Gehtland 写 的 《Spring: A Developer's Notebook) (O'Reilly) ， 
或 者 是 参考 由 Rod Johnson ` Juergen Hoeller ` Alef Arendsen ` Thomas 
Risberg 以 及 Colin SamplaneauG 4) (Professional Java Development 
with the Spring Framework) (WROX) 。 虽 然 本 书 的 作者 们 可 能 倾 辐 
于 多 推荐 O'Reilly 的 书目 ， 不 过 WROX 的 那 本 书 是 由 创建 和 维护 Spring 
Framework 的 那 帮 人 编写 的 。 


JRIH 


和 任何 开源 项 目 一 样 ， 最 终 真正 的 主 备 者 还 是 产 代 码 。 通 过 阅读 
源 代码 可 以 学 到 不 少 东 西 ， 而 不 仅仅 是 你 直接 关注 的 任务 。 当 然 ， 作 
为 Java 开 发 包 ， 根 据 源 代码 生成 的 JavaDoc 也 具有 相当 的 参考 价值 。 如 


果 你 在 用 Eclipse， 束 可 以 下 载 项 目的 源 代码 发 布 版 本 ， 再 告诉 Eclipse 
每 个 JAR 库 的 源 代码 目录 树 在 什么 地 方 。 这 样 做 的 价值 是 ， 在 编写 完 
成 类 、 方 法 名 称 、 参 数 时 ，Eclipse 会 提示 完整 的 JavaDoc 信 息 ， 通 过 F3 
快捷 键 也 可 以 打开 每 个 程序 元 素 的 源 代 码 ， 束 好 像 这 些 开源 代码 是 你 
目 己 的 项 目 一 样 。 我 们 发 现 这 是 一 种 非 党 具有 方向 性 和 辅助 学 习 的 好 
办 法 。 


如 果 使 用 Maven， 并 运行 eclipse: _ eclipse 构建 目标 ， 则 可 以 通过 以 
下 命令 来 下 载 源 代码 和 JavaDoc: 


mvn eclipse: eclipse-DdownloadSources=true 
-DdownloadJavadocs=true 


下 载 每 个 依赖 的 所 有 源 代 码 和 JavaDoc 包 可 能 需要 花费 不 少时 间 。 
在 本 地 Maven 仓 库 下载 好 源 代码 和 JavaDoc 以 后 ， 就 可 以 在 Edlipse IDE 
中 查看 依赖 库 的 源 代码 和 JavaDoc 了。 目前 广泛 使 用 的 开源 开发 库 的 绝 
大 部 分 (但 并 非 全 部 ) 都 提供 了 源 代 码 和 JavaDoc 工 件 。 


处 理 更 新 版 本 的 工具 包 


对 于 印刷 出 版 的 图 书 来 说 ， 软 件 的 不 断 变 化 忌 是 个 问题 。 因 此 ， 
当 你 在 使 用 本 书 涉及 的 所 有 这 些 软件 的 新 版 本 时 ， 可 能 会 过 到 些 麻 
烦 。 这 本 书 的 新 版 所 讨论 的 示例 基于 以 下 特定 版 本 的 各 种 工具 : 


Ant 1. 7.0 (有 时 会 遇 到 麻烦 和) 

Eclipse 3. 3.1.1 

Geronimo JTA 1. 1 implementation 
Hibernate 3. 2.5 

Hibernate Annotations 3. 3.0.ga 

Hibernate Commons Annotations 3. 3.0.ga 
Hibernate Tools 3. 2.0 beta 9a (很 多 地 方 ) 
Hibernate Tools 3. 2.0.GA (第 11 章 ) 
HSQLDB 1. 8.0.7 

Log4J 1. 2.14 (一 般 不 会 出 现 问 题 ) 
Maven 2. 0.8 

MySQL 5. 0.21 

Spring Framework 2.5 


Stripes 1. 4.3 


有 些 工具 的 更 新 版 本 可 能 会 改变 它们 的 工作 方式 ， 而 且 这 些 变化 
有 时 还 古 同 后 不 兼容 的 。 这 也 是 跟 上 开源 项 目 发 展 而 市 来 的 部 分 乐 
趣 。 我 们 提供 的 Maven 规 则 应 该 可 以 帮助 你 找到 我 们 要 使 用 的 工具 的 
特定 版 本 ， 这 样 会 对 你 的 学 习 和 试验 过 程 有 一 定 帮助 。 你 也 可 以 检查 
这 些 工具 包 的 发 行 说 明 ， 以 决定 在 什么 时 候 和 如 何 移 植 到 最 新 、 功 能 
最 强大 的 版 本 。 


你 还 可 以 在 本 书 网 站 (B) 的 勘误 页 面 上 看 看 是 否 也 有 其 他 人 遇 
到 了 与 你 同样 的 问题 ， 或 许 会 找到 解决 的 办 法 。 如 果 没 有 ， 也 请 你 尽 
可 能 提交 目 己 的 发 现 ， 与 别人 一 起 分 享 ! 


Hibernate 和 HSQLDB 都 有 各 目的 在 线 文 持 论 坛 ， 为 应 付 各 种 不 兼 
容 的 变化 提供 了 不 少 有 价值 的 建议 ， 也 可 以 学 到 这 些 工 具 其 他 方面 更 
为 复杂 的 东西 。 


HESS 


开放 源 代码 带 来 的 最 好 的 一 件 事情 就 是 你 不 仅 可 以 使 用 软件 ， 还 
可 以 参与 到 开发 社区 中 来 。 如 采 你 使 用 Hibernate、Spring、Ant、 
Maven 或 者 Stripes， 那 么 应 该 订阅 它们 的 用 户 邮 件 列 表 ， 以 保持 不 断 
了 解 其 更 新 和 新 版 本 情况 。 如 果 你 需要 对 源 代 码 进行 定制 ， 最 好 将 你 
的 修改 页 献 出 来 ， 所 有 这 些 项 目 都 有 非常 成 熟 的 开发 社区 ， 以 便 集 成 
你 对 代码 所 做 的 修改 。 在 对 技术 掌握 精深 以 后 ， 可 以 发 挥 一 下 主观 精 


神 ， 为 开发 人 员 的 邮件 列表 贡献 一 些 文档 补丁 。 不 必 对 参与 有 所 顾 
虑 ， 只 有 每 个 人 都 发 挥 主观 能 动 性 ， 开 源 事业 才 会 苗 壮 成 长 。 在 为 这 
些 项 目 做 贡献 时 ， 你 不 必 向 任何 人 申请 许可 ， 所 有 你 需要 做 的 就 是 喜 
起 勇气 、 开 始 参与 。 


要 了 解 有 关 Hibernate 社 区 的 更 多 详情 ， 并 着 手 参与 这 一 项 目 ， 可 
以 访问 Hibernate 的 官方 网 站 http://www.hibernate.org。 你 可 以 订阅 为 用 
户 和 开发 人 员 提 供 的 Hibernate 邮 件 列表 ， 或 者 是 按照 主页 上 的 提示 来 
看 看 它 的 支持 论坛 : http:/www.hibernate.org/20.html。Hibernate 团 队 的 
博客 也 非常 活跃 ， 其 网 址 是 http://blog.hibernate.org/。 将 这 个 博客 添加 
到 你 的 RSS 阅 读 器 中 ， 用 这 个 好 办 法 可 以 与 相关 的 技术 保持 同步 ( 例 
如 ，Seam 和 Hibernate Shards) ，Gavin 和 其 他 人 在 这 方面 的 开发 都 很 
活跃 。 


Spring Framework 与 一 个 叫做 Spring Source 
(http://www.springsource.com) 的 公司 有 关系 ， 这 个 公司 雇用 了 很 多 
志愿 者 为 Spring 项 目 做 贡献 。 有 关 Spring Framework 社 区 的 更 多 信息 ， 
可 以 访问 http:Wwww.springframework.org。 如 果 你 想 订 阅 邮 件 列表 或 者 
为 Spring Framework 页 献 源 代码 ， 则 应 该 看 看 开发 页 面 上 的 信息 ， 网 址 
是 http://www.springframework.org/development。 如 果 你 真 的 对 Spring 
Framework 怀 有 激情 ， 那 么 应 该 考虑 参加 Spring Source 的 年 度 会 议 : 


The Spring Experience。 有 关 Spring 培 训 的 信息 可 以 在 Spring Source 公 


司 的 网 站 上 找到 ， 有 关 The Spring Experience 的 信息 则 可 以 访问 该 会 议 


的 网 站 http://www.thespringexperience.com/。 


Apache Ant 和 Apache Maven 是 Apache Software Foundation (ASF) 
的 两 个 顶级 项 目 (top-level project) 。Apache Software Foundation 是 一 
个 大 型 的 开发 人 员 社 区 ， 相 关 信 息 可 以 访问 其 官方 网 站 
http:/www.apache.org。Apache 这 个 大 型 组 织 负责 维护 一 些 世 界 上 使 用 
最 广泛 的 项 目 ， 例 如 经 常 使 用 的 Apache Websk 3 a8 40 Tomcathy HEY 
服务 器 ， 以 及 Jakarta Commons 开 发 库 。 有 关 Apache Maven 开 发 社区 的 
详情 ， 可 以 访问 其 项 目 网 站 http:/maven.apache.org。 有 关 Apache Ant 开 
发 社区 的 更 多 详情 ， 也 可 以 访问 Ant 的 项 目 网 站 http:/ant.apache.org。 
Ant 和 Maven 都 是 非常 活跃 的 社区 ， 其 用 户 和 开发 人 员 的 邮件 列表 的 信 
尽量 都 非常 大 。 


Stripes 的 主页 是 http:/www.stripesframework.org， 在 这 个 网 站 上 可 
以 找到 相关 的 教程 、 参 考 文 档 以 及 JavaDoc。 要 订阅 这 个 项 目 在 
SourceForge 上 的 邮件 列表 ， 可 以 访问 https://source-forge.net/mail/? 
group_id=145476。 对 于 那些 Java 语 言 的 极 客 (geek) 来 说 ， 浏 览 
Stripes 的 源 代 码 应 该 是 种 有 趣 的 体验 ， 因 为 这 个 项 目的 开发 者 们 显然 
精通 并 使 用 了 目前 Java 的 最 新 功能 。 我 强烈 推荐 下 载 Stripes 的 源 代 码 
随意 看 看 ， 权 当 只 是 为 了 兴趣 而 已 。 


[1] http://www.oreilly.com/catalog/javadtabp/chapter/ch02.pdf. 


[2] http://www.sonatype.com/book/index.html. 
[3] http://www.oreilly.com/catalog/9780596517724/. 


MER til 


James Elliott 是 Berbee 公 司 的 一 位 资深 软件 工程 师 ， 有 近 20 年 的 系 
统 开 发 专业 经 验 。 他 对 计算 机 的 专注 和 油 情 早 在 职业 生涯 之 前 就 已 经 
显现 ， 当 他 在 Mexico City 上 中 学 时 就 得 到 了 一 台 标 着 "Apple 11" 的 古怪 
设备 ， 从 此 就 开始 了 在 计算 机 领域 的 驰 怠 。 


在 工作 环境 尚未 十 分 方便 之 前 ，Jim 就 已 经 开始 了 面向 对 象 的 开 
发 。 他 热衷 于 建造 高 质量 的 工具 和 框架 来 简化 其 他 开发 人 员 (而 不 只 
征 他 目 己 ) 的 工作 ， 喜 欢 研 究 如 何 有 效 地 使 用 Java 才 能 有 助 于 解决 实 
际 问题 ， 尤 其 是 当 这 一 语言 趋 于 成 熟 以 后 。 


在 经 历 了 环 游 世界 般 的 童年 时 代 以 后 ，Jim 在 位 于 纽约 州 的 
Rensselaer Polytechnic Institute 大 学 取得 了 学 士 学 位 ， 在 University of 
Wisconsin-Madison 取 得 了 硕士 学 位 ， 在 那 期 间 ， 他 也 在 贝尔 实验 室 

(位 于 Murray Hill, C 语 言 和 UNIX 的 诞生 地 ) 从 事 一 些 有 趣 的 工作 。 虽 
然 在 通过 博士 资格 考试 以 后 ，Jim 马 上 欣然 接受 了 现实 世界 的 诱惑 ， 但 
是 能 在 Madison 找 到 有 趣 的 工作 让 他 很 高 兴 。 他 目前 和 他 的 搭档 Joe 
Buberger 住 在 Madison ° 


Ryan Fowler 是 Berbee 公 司 的 一 位 软件 工程 师 。 他 的 编程 生涯 开始 
于 Apple I 机 右上 的 BASIC 语 言 ， 那 时 他 还 在 Michigan 州 Grand Rapids 


的 St.Stephen School 读 小 学 。 一 段 时 间 后 ， 他 又 回 到 Michigan 州 Alma 的 
Alma College 计 算 机 科学 系 写 代 码 ， 并 取得 了 学 士 学 位 。Ryan 喜 欢 清 
雪 、 航 海 ， 有 时 ， 也 弹 弹 吉他 来 打发 时 间 。Ryan 和 他 的 妻子 居住 在 
Wisconsin 的 Madison。Tim O'Brien 是 一 位 Emacs 信徒 ， 最 近 又 转向 了 
Apple Macintosh 计 算 机 。Tim 早 在 20 世 纪 80 年 代 初 就 开始 在 TRS-80 上 
编写 程序 ， 后 来 在 University of Virginia 学 习 电 子 工 程 。 作 为 独立 的 技 
术 人 员 ，Tim 经 常 与 Grassroots Technologies 合 作 ; 他 最 近 开 发 了 一 种 混 
搭 体系 结构 ， 可 以 为 金融 信息 、 客 户 保护 、 汽 车 以 及 教育 出 版 业 的 各 
种 客户 端 提 供 服 务 。 在 闲暇 时 间 ，Tim 喜 欢 睡觉 、 写 作 以 及 参与 开源 
文档 项 目 。Tim 目 前 和 妻子 Susan、 女 儿 Josephine 居 住 在 Illinois 的 


Evanston ° 


本 书 封面 上 的 动物 叫做 刺 狂 (hedgehog) ， 是 一 种 刺 狂 亚 科 
(Erinaceinae) 小 动物 。 目 前 已 经 发 现 了 5 属 16 种 刺 狂 ， 广 泛 分 布 在 欧 
洲 、 亚 洲 、 非 洲 和 新 西 兰 。 其 中 包括 : DOBRA (非洲 撒哈拉 以 
Pa) 、 长 耳 刺 狂 CE) > ORI (亚洲 和 中 东 ) ERR ER 
FE) 。 不 同类 的 刺 狂 体型 大 小 各 不 相同 ， 一 般 长 5 到 12 英 寸 ， 重 15 到 40 
号 司 。 作 为 驯养 的 刺 独 通 常 是 四 趾 刺 独 或 非洲 侏儒 刺 狂 ， 个 头 比 它们 
的 欧洲 同类 要 小 很 多 ， 目 前 已 经 在 很 多 国家 成 为 流行 的 宠物 。 刺 独 一 
词 最 早出 现 于 15 世 纪 中 期 一 “hedge 〈 树 管 ) ”， 因 为 它 的 根 长 在 地 下 ; 
而 "hog" GEJE) 则 是 因为 它 长 着 像 猪 一 样 的 口 鼻 。 刺 猎 的 其 他 名 称 还 
有 urchin、hedgepig 和 fueze-pig ° 


刺 狂 最 与 众 不 同 的 特点 束 是 它 的 赫 刺 ， 除 了 面部 、 腿 和 腹部 以 
外 ， 人 全身 都 长 满 了 刺 。 当 受到 惊吓 时 ， 它 会 卷 缩 成 球状 ， 全 号 杯 刺 坚 
立 ， 让 入 侵 者 无 从 下 手 。 这 些 刺 坚 硬 而 中 空 ， 由 角质 层 发 育 而 成 ， 非 
TEE o SRAKAR, RARR RE, BRIE ERA 
过 程 中 它 的 体 刺 才 会 脱落 。 


刺 狂 的 主要 食物 是 一 些小 型 无 有 椎 动物 ， 例 如 青蛙 、 毛 毛虫 以 及 
星 曙 。 一 些 刺 猎 能 够 抵抗 许多 毒素 ， 所 以 它们 可 以 吃 蜜蜂 、 黄 蜂 甚 至 
苹 毒 蛇 。 刺 猜 是 在 夜间 活动 的 动物 ， 而 白天 欢 在 草 从 中 岩石 下 面 或 地 


洞 中 睡 大 觉 。 尽 管 所 有 的 刺 猜 都 可 以 冬眠 ， 但 也 不 总 是 这 样 ， 因 为 冬 
眠 要 由 各 种 因素 来 决定 ， 比 如 地 点 、 温 度 以 及 食物 的 充足 程度 。 在 英 
国 ， 每 年 11 月 5 日 的 焰火 之 夜 (Bonfire Night) 的 庆祝 会 给 刺 独 带 来 很 
大 的 危险 ， 因 为 这 些小 动物 经 常会 躲 在 用 于 燃放 筹 火 的 木料 堆 中 有 睡 
觉 。 野 生动 物 保 护 组 织 同 公众 警告 ， 为 了 保护 正在 冬眠 的 刺 犹 ， 在 点 
火 以 前 一 定 要 检查 一 下 他 们 的 木料 堆 中 是 否 有 这 些 可 爱 的 小 动物 。 


封面 图 片 来 自 于 J.G.Wood 的 Animate Creation ° 


